


Selenium < 
WebDriver 3.0 > 
目 动 化 测试 框架 
实战 指南 


RRE 王 晨 昕 编著 


Python 语 言 版 


75 个 项 目 实例 5 种 测试 框架 
* 分 布 式 测试 框架 

* 行为 驱动 测试 框架 

* 数据 驱动 测试 框架 

太 关键 字 驱 动 测试 框架 

* 数据 关键 字 混 合 驱 动 测试 框架 


清华 大 学 出 版 社 


Selenium WebDriver 3. 0 
自动 化 测试 框架 实战 指南 


ARE IRU 编著 


清华 大 学 出 版 社 
北京 


内 容 简 介 


本 书 以 分 享 Selenium WebDriver 实战 经 验 为 要 ,致力 于 为 Tester 讲解 开源 的 Web 自动 化 测试 工具 的 
原理 api 接口 实例 、unittest、 五 大 框架 实战 (行为 驱动 .分 布 式 测试 框架 、 数 据 驱 动 测试 框架 、 关 键 词 驱动 测 
试 框架 ,混合 模式 测试 框架 ) 以 及 自动 化 测试 中 常见 的 问题 处 理 。 

本 书 既 可 让 初学 者 从 入 门 到 精通 ,循序 渐进 ; 也 可 帮 中 高 级 Tester 夯实 技能 ,从 形象 到 抽象 ,提供 测 
试 思想 中 更 多 的 可 能 性 。 


本 书 封面 贴 有 清华 大 学 出 版 社 防伪 标签 .无 标签 者 不 得 销售 。 
版 权 所 有 ,侵权 必 究 。 侵 权 举 报 电话 : 010-62782989 13701121933 


图 书 在 版 编目 (CIP) 数 据 

Selenium WebDriver 3. 0 自动 化 测试 框架 实战 指南 / 吴 晓 华 , 王 晨 昕 编著 . 一 北京 : 清华 大 学 出 版 社 ， 
2017 

ISBN 978-7-302-48317-5 


I.GS- I. ORe @ 王 … M. 软件 工具 一 自动 检测 一 指南 IV. DTP311. 56-62 


中 国 版 本 图 书馆 CIP 数据 核 字 (2017) 第 218517 号 


责任 编辑 : 页 xb i 阳 
封面 设计 : 刘 键 
责任 校对 : 李 建 庄 
责任 印 制 : 沈 M 


出 版 发 行 : 清华 大 学 出 版 社 


网 HE: http://www. tup. com. cn, http://www. wqbook. com 
地 A: 北京 清华 大 学 学 研 大 厦 A 座 AB  ” 编 : 100084 
社 总 机 : 010-62770175 邮 购 : 010-62786544 


投稿 与 读者 服务 : 010-62776969, c-service@tup. tsinghua. edu. cn 
质量 反馈 : 010-62772015, zhiliang@ tup. tsinghua. edu. cn 
课件 下 载 : http://www. tup. com. cn,010-62795954 

: 三 河 市 君 旺 印 务 有 限 公 司 

: 全 国 新 华 书店 

: 185mm X 260mm E) 张 : 26.75 字 

: 2017 年 9 月 第 1 版 印 

: 1 一 3000 

: 69.00 元 


E 


| s WR BGcG 


: 646 FF 
: 2017 4 9 月 第 1 次 印刷 


ASEH 
LE 





* 
En 
E 


: 075534-01 


一 人 一 


ny 


e 


随 着 互联 网 的 高 速 发 展 ,中 国 的 互联 网 达到 了 一 个 空前 的 繁荣 水 平 , 数 亿 量 级 用 户 的 产 
品 登 上 了 中 国 的 互联 网 发 展 舞 台 , 阿 里 巴巴 、 腾 讯 、 百 度 等 多 个 互联 网 巨头 也 开始 在 世界 的 
互联 网 舞台 轩 露 头角 ,互联 网 行业 的 从 业 人 员 也 达到 了 上 百 万 人 的 规模 ,中 国 的 互联 网 产品 
已 经 深入 到 网 民生 活 的 各 个 方面 。 

随 着 互联 网 行业 在 中 国 的 迅猛 发 展 ,对 于 中 国 的 软件 开发 和 测试 行业 也 提出 了 更 高 的 
技术 要 求 与 质量 要 求 , 软 件 测试 从 业者 的 技术 水 平 也 被 提升 到 空前 的 高 要 求 阶 段 。 以 往 我 
们 看 到 测试 人 员 的 招聘 重点 都 是 仅 限于 对 测试 用 例 设计 和 业务 的 理解 ,现今 所 看 到 的 更 多 
测试 职位 对 测试 人 员 提 出 了 更 高 的 技术 能 力 要 求 。 例 如 ,精通 一 门 编程 语言 ,熟悉 MySQL 
或 者 Oracle 数据 库 ,精通 自 动 化 测试 和 性 能 测试 ,能 独立 开发 测试 工具 等 。 为 了 能 更 好 地 
适应 互联 网 社会 的 发 展 潮流 ,软件 测试 从 业者 必须 在 技术 能 力 上 不 断 地 提升 自己 ,才能 真正 
站 在 职业 发 展 的 丹 峰 。 

自动 化 测试 技术 对 测试 人 员 来 说 ,是 一 个 必要 的 高 级 技能 要 求 , 越 来 越 多 的 测试 从 业者 
并 不 甘于 手工 测试 ,都 非常 希望 通过 自动 化 的 方式 来 减少 枯燥 无 味 且 不 断 重复 的 手工 测试 
劳动 。 尽 管 ,主流 的 Web 自动 化 测试 开源 工具 Selenium WebDriver, 已 经 成 为 众多 软件 测 
试 从 业者 学 习 的 热点 ,但 是 市 面 上 针对 Selenium 自动 化 测试 方面 的 书籍 很 少 ,基于 实践 方 
式 来 讲解 Selenium 应 用 技术 的 书籍 更 是 凤毛麟角 。 我 有 幸 受 吴 老 邀请 ,将 我 工作 中 实践 内 
容 与 吴 老 教学 内 容 融 合 ,一 起 编写 了 这 本 基于 Python 语言 实践 操作 的 Selenium 3 教学 书 
籍 ,来 解决 软件 测试 人 员 学 习 自 动 化 测试 的 需求 。 

Selenium 是 一 个 开源 的 测试 工具 ,代表 了 未 来 测试 工具 的 趋势 ; 而 Python 则 是 全 世界 
都 在 用 的 一 门 简 洁 、 高 效 , 易 用 ,优雅 的 编程 语言 .初学 者 只 需要 花 少 量 的 时 间 就 能 上 手 , 并 
完成 一 定量 的 开发 任务 。 但 本 书 着 重点 在 讲解 Selenium 的 使 用 技巧 上 ,对 学 习 Python ifi 
言 有 需要 的 朋友 ,请 自行 购买 相关 资料 或 者 利用 丰富 的 网 络 资源 。 

本 书 采用 图 文 并 茂 的 方式 分 步骤 讲解 Selenium 的 各 种 实用 技巧 ,并 且 提 供 被 测试 对 象 
的 实现 代码 或 者 被 测试 对 象 的 访问 网 址 ,方便 读者 在 本 地 搭建 自己 的 测试 环境 或 者 访问 互 
联网 上 的 被 测试 网 址 ,从 而 能 顺利 地 进行 自动 化 测试 技术 的 实践 。 经 过 我 们 数 月 的 不 懈 努 
力 ,此 书 终于 跟 大 家 见面 了 .希望 能 够 让 读者 通过 本 书 深入 掌握 Selenium 3 的 使 用 技巧 , 帮 
助 大 家 在 自动 化 测试 方向 上 能 大 展 身手 。 我 们 相信 ,通过 我 们 不 断 的 努力 ,一 定 可 以 改变 中 
国 测试 行业 技术 含量 低 的 现状 。 

作为 一 个 土生 土 长 的 测试 人 员 ,不 懂 技术 ,工作 中 经 常会 被 各 种 大 咖 人 物 丢 来 一 个 不 导 
的 眼神 ,甚至 有 的 人 连 不 悄 的 眼神 都 懒得 丢 , 直 接 无 视 , 此 时 我 的 内 心 是 很 崩溃 的 (大 冉 )。 
2015 4E ,在 一 个 机 缘 巧 合 下 认识 了 吴 老 ,他 丰富 的 测试 经 验 和 过 硬 的 技术 都 让 我 折服 ,我 就 
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fà — ELE DR rp RT AR T PHOG DEG HUE OLET SU GRE RE 6 CLR ERECTA P 
因为 好 不 容易 遇见 这 么 一 位 低调 奢华 有 内 涵 的 大 神 , 岂 能 放 过 ( 偷 笑 ) ,于 是 我 很 乐意 就 死 皮 
赖 脸 地 揪 着 吴 老 , 套 他 的 各 种 本 领 。 当 时 的 每 一 天 除了 吃饭 .工作 及 少量 的 睡觉 时 间 ,其 余 
时 间 不 是 吃 斋 (看 书 ) ,就 是 念佛 ( 敲 代码 ) , 那 日 子 其 是 枯燥 ,其 是 无 味 ,期 盼 着 咸 鱼 能 有 翻身 
的 一 天 。 我 待 Code 如 初恋 ,Code 虐 我 千 百 遍 (苦笑 ) ,半年 时 间 过 去 了 ,被 虐 得 千 疮 百 孔 的 
我 也 算是 摸 清 Code 的 脾气 了 , 闲 来 无 事 也 能 写 上 几 百 行 了 ,算是 有 点 欣慰 吧 。 

有 了 一 定 的 Code 功底 后 ,开始 正式 进入 自动 化 学 习 。 自 动 化 测试 的 学 习 是 一 个 不 断 
实践 ,不 断 总 结 ,不 断 积累 的 过 程 。 很 多 人 会 有 一 个 错误 的 认识 ,认为 自动 化 测试 不 就 是 一 
个 工具 的 使 用 ,一 个 调用 别人 写 好 的 API 的 过 程 么 ,需要 那么 深厚 的 Code 功底 有 何 用 ? vk 
不 知 你 此 时 仅 是 一 个 ToolBoy 或 者 ToolGirl, 要 想 随 心 所 欲 的 完成 各 种 自动 化 测试 ,无 论 是 
Web 自动 化 ,移动 端 自 动 化 ,还 是 性 能 自动 化 ,都 必须 在 拥有 一 定 的 Code 功底 后 , 方 能 理解 
这 些 工具 底层 实现 的 原理 ,并 且 能 在 当 工 具 本 身 不 能 满足 测试 需求 时 ,还 能 随心 所 欲 地 扩充 
或 更 改 。 理 解 了 这 些 工具 的 实现 思想 ,也 就 为 您 搭建 属于 自己 的 测试 框架 打下 了 坚实 的 基 
础 。 经 过 半年 的 踩 蹦 与 被 踩 蹦 ,加 之 工作 中 的 不 断 实 践 , 也 能 搭建 那么 几 个 自己 还 算 满 意 的 
测试 框架 ,做 得 还 其 是 开心 ( 偷 笑 ) ,而 且 还 能 被 吴 老 盯 上 , 叫 来 编写 这 本 书 , 也 着 实 有 点 小 开 
心 (得 意 ) 。 

这 是 我 第 一 次 写 一 本 专著 技术 类 的 书籍 , 深 深 地 感觉 到 把 知识 点 用 通俗 易 通 的 语言 描 
述 清楚 是 一 件 多 么 不 容易 的 事 ,为 此 我 投入 了 大 量 的 时 间 与 精力 来 组 织 本 书 的 语言 ,如 果 还 
是 存在 不 那么 浅显 易 懂 的 语句 ,请 先 尝试 从 代码 层面 进行 理解 ,但 如 果 在 实践 本 书 中 代码 时 
发 生 了 错误 ,请 不 要 怀疑 是 我 们 代码 的 问题 ( 坏 笑 ) ,请 先 检查 您 的 环境 是 否 有 问题 ,浏览 器 
版 本 与 驱动 版 本 是 否 匹配 ,所 使 用 的 Python 包 版 本 之 间 是 否 存在 版 本 兼容 的 问题 ,Python 
代码 是 否 存在 缩 进 问题 等 。 如 果 仍 然 解决 不 了 您 的 问题 ,欢迎 把 错误 丢 到 笔者 的 脸 上 ,我 们 
定 会 马不停蹄 地 帮 您 解决 。 

冰冻 三 尺 , 非 一 日 之 寒 ,希望 大 家 能 在 自动 化 测试 学 习 的 道路 上 做 到 博 观 而 约 取 , 厚 积 
而 薄 发 。 最 后 , 祝 大 家 工作 顺利 ,万 事 如 意 。 

本 书 内 容 介绍 如 下 : 

第 一 篇 ”基础 篇 (第 1~8 章 ) 

第 1 章 介绍 Selenium 的 发 展 历史 及 组 成 Selenium 的 工具 套件 ,列举 了 Selenium 1 和 
Selenium 2 支持 的 浏览 器 和 平台 ,讲解 Selenium RC 和 WebDriver 的 实现 原理 ,同时 也 介绍 
了 Selenium 1,Selenium 2 和 Selenium 3 的 各 自 特点 及 区 别 。 

第 2 章 介绍 在 日 常 测试 工作 中 常见 的 自动 化 测试 目标 ,讲解 如 何 获得 公司 管理 层 对 于 
开展 自动 化 测试 的 支持 ,如 何 衡量 自动 化 测试 工作 的 投入 产 出 比 及 在 敏捷 开发 中 的 应 用 、 以 
及 自动 化 测试 工作 的 分 工 及 测试 工具 的 选择 与 推广 ,分 享 在 实际 项 目 中 最 佳 的 实践 经 验 ,说 
明了 学 习 Selenium 工具 的 能 力 要 求 。 

第 3 章 介 绍 使 用 Selenium 工具 时 所 需要 的 相关 辅助 插件 FireBug 和 FirePath 的 安装 
及 使 用 方法 。 

第 4 章 介绍 Selenium IDE 的 安装 ,界面 选项 的 含义 、IDE 的 使 用 方法 ,录制 脚本 及 导出 
脚本 等 。 

第 5 章 介 绍 Python 开发 环境 和 Pycharm 集成 开发 环境 的 安装 、 配 置 及 使 用 。 
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第 6 章 介 绍 WebDriver 的 安装 和 配置 方法 。 

第 7 章 主要 介绍 单元 测试 的 基本 知识 ,如 何在 自动 化 测试 中 使 用 以 及 生成 测试 报告 。 

第 8 章 主要 讲解 自动 化 测试 过 程 中 使 用 的 页 面 元 素 定 位 方法 ,包括 ID 定位 `Name 定 
位 .链接 文字 定位 ,Class 定位 ,XPath 定位 及 CSS 定位 ,推荐 使 用 XPath 作为 页 面 元 素 定位 
的 主要 方法 。 

第 二 篇 ”实战 应 用 篇 (第 9~11 章 ) 

第 9 章 讲解 如 何 使 用 WebDriver 工具 分 别 驱动 IE 浏览 器 .Chrome 浏览 器 以 及 Firefox 
浏览 器 ,进行 自动 化 测试 。 

第 10 章 通过 实例 全 面 讲解 WebDriver 基础 API。 

第 11 章 通过 实例 全 面 讲解 WebDriver 高 级 API, 并 提供 一 些 解决 实际 问题 的 方法 。 

第 三 篇 自动 化 测试 框架 搭建 篇 (第 12 一 15 章 ) 

第 12 章 讲解 数据 驱动 的 概念 ,并 基于 Excel; XML, MySQL 及 单元 测试 框架 结合 ddt 
进行 数据 驱动 测试 。 

第 13 章 讲解 lettuce 行为 驱动 框架 在 自动 化 测试 中 的 使 用 ,分 别 基于 英文 和 中 文 进行 
实例 讲解 。 

第 14 章 通过 实例 全 面 讲解 如 何 基于 Selenium Grid 进行 分 布 式 自动 化 测试 。 

第 15 章 深入 讲解 如 何 从 零 开始 搭建 一 个 数据 驱动 测试 框架 、 关 键 字 驱 动 测 试 框架 以 及 
数据 驱动 与 关键 字 驱 动 混合 的 测试 框架 ,并 提供 完整 的 框架 代码 。 此 章节 为 本 书 最 综合 、 
重要 的 章节 ,建议 读者 在 阅读 完 前 面 所 有 章节 后 再 阅读 此 章节 。 

第 四 篇 ”常见 问题 和 解决 方法 (第 16 章 ) 

第 16 章 讲解 WebDriver 使 用 过 程 中 常见 的 疑难 问题 及 解决 办 法 ,方便 读者 在 使 用 
WebDriver 的 过 程 中 遇 到 问题 时 进行 查阅 。 


特别 致谢 


感谢 我 们 的 好 朋友 陈 良 军 , 李 江 和 王 浩 花费 大 量 的 时 间 与 精力 帮 有 我 们 校对 书稿 ,发现 了 
不 少 书写 的 错误 , 星 涩 难 懂 的 语句 以 及 代码 的 错误 ,在 此 笔者 们 真诚 地 感谢 他 们 对 本 书 做 出 
的 贡献 ,帮助 我 们 完成 这 件 非常 有 意义 的 事情 。 





XU ERU 
2017 年 6 月 





第 一 篇 基 础 篇 


第 1 章 Selenium 简介 


1.1 
1.2 
1.3 


1.5 


第 2 章 自动 化 测试 那 点 事 儿 … 


1 
2 
3 
4 
5 
6 


2.7 
2.8 


Selenium 工具 套件 介绍 
Selenium 支持 的 浏览 器 和 平台 a Rd as 
1.3.1 Selenium IDE,Selenium 1 和 Selenium RC 支持 的 浏览 器 和 平台 …… 2 
1.3.2 Selenium 2(WebDriver) 支 持 的 浏览 器 vM 

Selenium RC 和 WebDriver 的 实现 原理 - 
1.4. 1. Selenium BEWSA eec eec detee lee edi edet tandis 
1.4.2 WebDriver 的 实现 原理 …… 
1.4.3 Selenium 1. 0 和 WebDriver 的 特点 
















iini EDU E P ne eh E 
投入 产 出 比 ee 3 

敏捷 开发 中 的 自动 化 测试 应 用 
自动 化 测试 人 员 分 工 …………… 
自动 化 测试 工具 的 选择 和 推广 使 用 … 1a 
2.6.1 自动 化 测试 工具 的 选择 - LC 14 
2.6.2 Selenium WebDriver 和 QTP 工具 的 特点 比较 e 104 
在 项 目 中 实施 自动 化 的 最 佳 实践 … ee 

学 习 Selenium 工具 的 能 力 要 求 - CE | 





第 3 章 自动 化 测试 辅助 工具 - a ee S MÀ 


3.1 
3.2 
3.3 


安装 Firefox WEAR emm 18 
安装 Firebug 播 件 eH 18 
Firebug 捅 件 的 使 用 MH 20 
3.3.1 启动 Firebug diff pp 20 
3.3.2 Firebug fF] HIXIBE rm 20 


` Selenium WebDriver 3.0 自动 化 测试 框架 实战 指南 
e 


3.4 安装 FirePath 插件 

3.5 FirePath fif hJ {EH ee 
3.5.1 FirePath 插件 中 使 用 XPath 定位 方式 … ETT s jà 
3,5.2 FirePath 插件 中 使 用 CSS 定位 方式 emm 26 

3.6 IENIE ELE UAE BDEACERA ener nennen D8 


- 22 
… 24 

















第 4 章 Selenium IDE PP - 30 
4.1 Selenium IDE 的 定义 : 30 

4.2 EX Seenium IDE. “ii .. 30 
4.2.1 从 Selenium 官网 安装 …………… .. 30 

4.2.2. 使 用 离线 XPI 安装 文件 安装 = -a2 

4.3 Selenium IDE 插件 界面 和 功能 介绍 - 33 
4.3.1 主 界面 . PES . 33 

4.3.2. 常用 工具 栏 --—— MM ETT 

4.3.3 脚本 编辑 区 域 ……………… M» 





«34 








4.4.3 Actions 3 
4.4.4 Option 3€ 
4.5 录制 和 回放 脚本 实例 … 








4.6 Selenium IDE 脚本 介绍 一 一 Selenese : 39 
4.7 Selenium IDE 的 基本 命令 使 用 实例 40 
4.7.1  waitForText, verifyText 和 assertText 命令 en: 40 
4.7.2  storeTitle 命令 和 echo p cmm 44 
4.7.3  openWindow 命令 和 select Window 命令 MM * 44 
4.8 J Selenium IDE 导出 脚本 - 45 





4.8.1. 导出 脚本 文件 - 有 
4.8.2 $ Selenium IDE 插件 中 的 某 行 命令 导出 为 Python 脚本 …………… 48 
第 5 章 搭建 Python 环境 和 PyCharm 集成 开发 环境 … 
5.1 安装 Python 并 配置 Python 环境 
5.1.1 下 载 并 安装 Python 解释 器 
5.1.2 配置 Python 环境 
5.1.3 安装 pip sid 
5.2 安装 Python 集成 开发 环境 PyCharm 
5.3. 新建 一 个 Python LRE eee n 
第 6 章 Selenium3(WebDriver) 的 安装 eH 58 


6.1 在 Python 中 安装 WebDriver pp 58 
6.2 第 一 个 WebDriver BA& — eee enm 59 

















8$ a3 


6.3 4 WU ME DR ICH HO EE eene 62 
第 7 章 单元 测试 框架 的 使 用 介绍 eonenn 63 


yt a eem mnm nemen een e 63 
2.1 unittest 的 定义 eH 63 
unittest 框架 的 4 PERPA ee HH 63 
pe RH r—————Ó—— M — E Óà 
.11 fiif HTMLTestRunner 生成 HTML 测试 报告 m 85 
7.3 dE unittest 中 运行 第 一 个 WebDriver 测试 用 例 HH 87 
使 用 name 定位 .. 91 
T E EEA a AE ee ead 
MB HTML ig E e eE r e e Og 
bi | o ETT 
8.8.3. XPath 定位 语法 ———— S ÉET. 
8.8.4 XPath 运算 符 … 101 
人 
8/9.1 "CSS BMEAE. enciende prt o erectae eiaei 103 
8.9.2 CSS EME E HH 103 
8.9.3 POUSSE RON INIRE eH en een eee 109 
8.10.1 遍历 表格 所 有 的 单元 格 … eene Hee eene 110 
8.10.2 jg B EBCBESECTOUE MH 
8.10.3 jEfU dA PET ODXX eM 112 





o 0 -30 0c &£U t 


2 
2 
2 
2 
2. 
2 
2 
2 
2 


NNN c3 o3 c3 c3 c3 c3 n3 


~ 





$0 9» go go go go go go 
oo -3 aN &R to F9 — 


fe 





e 
: Selenium WebDriver 3.0 自动 化 测试 框架 实战 指南 
L7 


第 二 篇 ”实战 应 用 篇 
9 93-; WebDriver 的 多 浏览 器 测 斌 o 15 
9.2- MIB Firefox 浏览 强 进 行 测 写 020s 118 
9.3 使 用 Chrome 浏览 器 进行 测试 eH 117 
第 10 章 WebDriver API 详解 «eM 119 


10.2 网 页 的 前 进 和 后 退 … - 120 

10.3 刷新 当前 网 页 …… - 120 

10.4 ”浏览 器 窗口 最 大 化 ………… . 120 
5 dkNOfF CELL LEE RH 121 
6 dZkHOfRULEWiBE ED BAIN Hm 121 
8 
9 










3RHBUR EP HTML IR) eurn en 122 





获取 当前 页 面 的 URL 地 址 eee 123 
10.10 ”获取 与 切换 浏览 器 窗口 句柄 pp s» 123 
10.11 获取 页 面 元 素 的 基本 信息 … . 
10.12 获取 页 面 元 素 的 文本 内 容 
10.13 ”判断 页 面 元 素 是 否 可 见 … 
10.15 获取 页 面 元 素 的 属性 eem 128 
10.16 ”获取 页 面 元 素 的 CSS 属性 值 M 128 
10.18 在 答 入 检 中 输入 指 定 内 容 i AE 
10.20 ”双击 某 个 元 素 . eee —— 130 
10.21 操作 单 选 下 拉 列 表 - eel ee n 131 

10.21.1 遍历 所 有 选项 并 打印 选项 显示 的 文本 和 选项 值 :131 

10.21.2 选择 下 拉 列 表 元 素 的 三 种 方法 … : 132 
10.22 断言 单 选 列 表 选 项 值 ， - 133 
10.23 ”操作 多 选 的 选择 列表 - eA eee 133 
10.24 操作 可 以 输入 的 下 拉 列表 (输入 的 同时 模拟 按键 ) eem 134 
10.25 操作 单 选 框 . Se eee 135 
10.26 操作 复 选 框 ， 36 
10.27 断言 页 面 源码 中 的 关键 字 ee 137 
10.28 对 当前 浏览 器 窗口 截屏 138 













————e 


10.30 ”模拟 键盘 单个 按键 操作 139 
10.31 模拟 组 合 按键 操作 - ee €——— 140 
10.31.1 通过 WebDriver 内 建 的 模块 模拟 组 合 键 eee 140 
10.31.2 通过 第 三 方 模块 模拟 组 合 按键 … EET 
10.31.3 s 通过 设置 剪贴 板 实现 复制 和 粘贴 … ELI 
10.03 MUR CRM S REC ~ - 148 
10.34 (idbikBUb REGE dEN AT JSEX LE eee MMMMHMMHHRHMHHMHHHHHMÜÉÓM J49 
10.38 mr ji šā * 154 
10.39 使 用 Title 属性 识别 和 操作 新 弹出 的 浏览 器 窗口 ，157 
10.40 ”通过 页 面 的 关键 内 容 识别 和 操作 新 浏览 器 窗口 … - 159 
10.41 操作 Frame 中 的 页 面 元 素 … ee pr Pe PT T 
10.42 {EJH Frame 中 的 HTML 源码 内 容 操 作 Frame mM 162 
10.43 操作 IFrame 中 的 页 面 元 素 1163 
10.44 操作 JavaScript 的 Alert 弹 窗 emm HIR 165 
10.45 操作 JavaScript 的 confirm 弹 窗 ，166 
10.46 操作 JavaScript 的 prompt 弹 窗 … ， 167 
10.47. 操作 浏览 器 的 Cookie ……… - 169 
10.48 指定 页 面 加 载 时 间 ee ITO 
第 11 章 WebDriver 高 级 应 用 PN 1]72 
11.1 使 用 JavaScript 操作 页 面 元 素 2 
2 操作 Web 页 面 的 滚动 条 e - 173 
3 在 Ajax 方 式 产生 的 浮动 框 中 , 单 击 选择 包含 某 个 关键 字 的 选项 ， < 174 
11.4 结束 Windows 中 浏览 器 的 进程 … ss Ez 1077 
5 
6 
7 

























EA Som 8 TERR - a E MM i 
无 人 工 干 预 地 自动 下 载 某 个 文件 - a | 
无 人 工 干预 地 自动 上 传 附件 nem ee 183 
11.7.1 使 用 WebDriver 的 send keys 方法 上 传 文件 Ep OS 
11.7.2 模拟 键盘 操作 ,实现 上 传 文件 … is < 184 
11.7.3. 使 用 第 三 方 工具 Autolt 上 传 文件 … - 187 
.8 右键 另存 为 下 载 文件 : 192 I 
.9 REHMET - ee S f 

.10 启动 带 有 用 户 配 置信 息 的 Firefox 浏览 器 窗口 - ee eMe 196 
.11 UIE - MM we i. dui 
.12 操作 富 文本 框 … Pr a Ol 














jd pd ipm ed 








bak je pes jud cp cj oes a cn ce je 
- 
to 





N 
- 


Selenium WebDriver 3.0 一 自动 化 测试 框架 实战 指南 


高 亮 显示 正在 操作 的 页 面 元 素 … 0 
浏览 器 中 新 开标 签 页 (Tab) n —— 
测试 过 程 中 发 生 异 常 或 断言 失败 时 进行 屏幕 截图 … ee 212 
使 用 日 志 模 块 记录 测试 过 程 中 的 信息 …… Dd 

封装 操作 表格 的 公用 类 … Na 
测试 HTML5 语言 实现 的 视频 播放 器 … 
在 HTML 5 的 画布 元 条 上 进行 绘画 操作 
使 用 C Chrome T 览 器 自动 将 文件 下 载 到 指定 路 径 … 和 
屏蔽 Chrome 的 --ignore-certificate-errors 提示 及 禁用 扩展 插件 并 实现 
窗口 最 大 化 … "zs " 
禁用 Chrome 浏览 器 的 PDF 和 Flash fif «ee 229 
局 动 Firefox 的 同时 打开 Firebug + 
禁用 Chrome 浏览 器 中 的 Image 加 载 ………… 
禁用 Firefox 浏览 器 中 的 CSS, Flash 及 Image JI «m 234 


第 三 篇 ”自动 化 测试 框架 搭建 篇 















N 
20 00 t 


nuuc cac a nk. WO 
使 用 unittest 和 ddt 进行 数据 驱动 pp 238 
使 用 数据 文件 进行 数据 驱动 …… . 

使 用 Excel 进行 数据 驱动 测试 … 
使 用 XML 进行 数据 驱动 测试 . 
使 用 MySQL 数据 库 进 行 数据 驱动 测试 n m 254 





1 
2 
3 
4 
13.5 
6 
7 
8 
9 


T1298 sli JE ERI lettuce IF eriein ineens anpra dataene aiina 261 
行为 驱动 测试 的 环境 准备 

第 一 个 英文 语言 行为 驱动 测试 、 
通过 类 模式 实现 英文 行为 驱动 - 
lettuce 框架 的 步骤 数据 表格 EE 
使 用 WebDriver 进行 英文 语言 的 行为 数据 驱动 测试 en mm 
使 用 WebDriver 进行 中 文 语 言 的 行为 数据 驱动 测试 
Esc: a PU 








第 14 章 Selenium Grid 的 使 用 ee 


14.1 


Selenium Grid 简介 e285 


一 一 一 一 一 一 


分 布 式 自动 化 测试 环境 准备 ee eee eee 286 
Selenium Grid 的 使 用 方法 … eA E ET e LH EE TT 
14.3.1 远程 调用 Firefox 浏览 器 进行 自动 化 测试 ee 290 
14.3.2 远程 调用 IE 浏览 器 进行 自动 化 测试 e 294 
14.3.3 远程 调用 Chrome 浏览 器 进行 自动 化 测试 e 295 
14. 3.4 同时 支持 多 个 浏览 器 进行 自动 化 测试 n 296 

14.4 结合 unittest 完成 分 布 式 自动 化 测试 ………… 

14.5 实现 并 发 的 分 布 式 自动 化 测试 、 
第 15 章 自动 化 测试 框架 的 搭建 及 测试 实战 303 
15.4 关键 字 & &. 数据 混合 驱动 框架 及 实战 … AE i dae 


第 四 篇 “常见 问题 和 解决 方法 


第 16 章 自动 化 测试 常见 问题 和 解决 方法 PN 405 
16.1 如 何 让 WebDriver 支持 IE 11 pp 405 
16.2 解决 “Unexpected error launching Internet Explorer. Browserzoom 
level was set to 7596 (BEIC ELA HO" BUABR eee 407 
16.3 ”解决 某 些 TE 浏览 器 中 输入 数字 和 英文 特别 慢 的 问题 een nee 407 
16.4 解决 Firefox 浏览 器 的 can't access dead object 异常 eem 408 
16.5 常见 异常 和 解决 方法 - "RU TT 


14. 
14. 


w to 






第 一 篇 “基础 篇 
Ds 


ST 章 Selenium 简介 


Selenium 工具 诞生 的 时 间 已 经 超过 10 年 ,目前 在 软件 开发 公司 中 已 得 到 大 规模 的 应 
用 ,但 是 很 少 有 人 能 够 清楚 地 描述 此 工具 的 发 展 历史 和 特点 ,通过 本 章 的 介绍 让 读者 和 
Selenium 工具 来 一 次 亲密 的 接触 ,以 便 了 解 它 的 前 世 今 生 及 其 特点 。 


1.1 BEIJING SET RU 


2004 年 在 ThoughtWorks 公司 ,一 个 名 为 Jason Huggins 的 兄弟 为 了 减少 手工 测试 的 
工作 量 ,自己 实现 了 一 套 基 于 JavaScript 的 代码 库 , 使 用 这 套 代码 库 可 以 进行 页 面 的 交互 操 
fe ,并 且 可 以 重复 地 在 不 同 浏览 器 上 进行 各 种 测试 操作 。 通 过 不 断 的 改进 和 优化 ,这 个 代码 
库 逐 步 成 为 Selenium Core, Selenium Core 为 Selenium Remote Control (RC) fl Selenium 
IDE 提供 了 坚实 的 核心 基础 能 力 。 

当时 的 自动 化 测试 工具 比较 稀少 , 现 有 的 工具 也 无 法 灵活 地 支持 各 种 复杂 的 测试 操作 ， 
大 部 分 测试 人 员 只 能 使 用 手工 的 方式 完成 Web 产品 的 测试 工作 。 开 发 人 员 不 断 地 开发 代 
码 ,测试 人 员 不 断 地 发 现 bug, 开 发 人 员 不 断 地 修改 bug ,测试 人 员 不 断 地 回归 测试 ,以 确认 
bug 是 否 被 修正 ,并 且 确 认 程 序 没 有 引入 新 的 bug。 这 样 的 产品 开发 模式 ,导致 测试 人 员 必 
须 经 常 手工 回归 测试 系统 的 大 部 分 功能 ,由 此 产生 了 大 量 的 重复 性 手工 操作 。Jason 
Huggins 想 改变 这 样 的 现状 ,所 以 他 开发 了 基于 JavaScript 的 代码 库 ,希望 帮助 测试 人 员 从 
日 常 的 重复 性 工作 中 解脱 出 来 ,经 过 不 断 的 努力 ,Selenium 1.0 版 本 诞生 了 。 

Web 自动 化 测试 工具 Selenium 是 跨 时 代 的 ,因为 它 允 许 测试 工程 师 使 用 多 种 开发 语 
言 来 控制 不 同类 型 的 浏览 器 ,从 而 实现 不 同 的 测试 目标 。Selenium 是 开源 工具 软件 ,用 户 
无 须 付 费 就 可 以 使 用 它 ,甚至 可 以 根据 自己 的 使 用 需求 来 进行 深入 的 定制 化 ,改写 其 原 有 的 
一 些 功能 。 基 于 以 上 这 些 优 点 , 越 来 越 多 的 测试 人 员 开始 使 用 此 工具 来 进行 Web 系统 的 自 
动 化 测试 工作 。 在 短 短 几 年 时 间 内 ,全 世界 范围 内 都 出 现 了 Selenium 工具 的 忠实 拥护 者 ， 
目前 中 国 的 几 大 互联 网 公司 均 使 用 Selenium 作为 Web 自动 化 测试 实施 的 主要 工具 。 

但 是 随 着 互联 网 技术 的 不 断 发 展 以 及 浏览 器 对 于 JavaScript 语言 的 安全 限制 ， 
Selenium 的 发 展 也 遇 到 很 多 难以 解决 的 困难 。 由 于 其 自身 实现 的 机 制 ,Selenium 无 法 突破 
浏览 器 沙 盒 的 限制 ,导致 很 多 测试 场景 的 测试 需求 难以 被 实现 。 

2006 年 ,Google 的 工程 师 Simon Stewart 开启 了 一 个 叫做 WebDriver 的 项 目 , 此 项 目 
可 以 直接 让 测试 工具 调用 浏览 器 和 操作 系统 本 身 提供 的 内 置 方法 ,以 此 来 绕 过 JavaScript 
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环境 的 沙 盒 限 制 ,WebDriver 项 目的 目标 就 是 为 了 解决 Selenium 的 痛处 ,并 且 也 做 到 了 。 
2008 年 北京 奥运 会 胜利 召开 的 那 年 , Selenium 和 WebDriver 这 两 个 项 目 进 行 了 合并 ,至 此 
Selenium 2.0 出 现 了 ,也 就 是 我 们 现在 常常 看 到 的 Selenium WebDriver( 简 称 WebDriver) 。 

Selenium? =Seleniuml] 十 WebDriver 

Selenium 的 官网 地 址 是 www. seleniumhq. org, 网 站 提供 了 Selenium WebDriver 的 安 
装 文件 和 使 用 教程 。Selenium2 是 Selenium 1 的 升级 版 本 , 它 本 身 向 下 兼容 Selenium 1 的 
所 有 功能 ,同时 又 提供 了 更 多 新 API 来 完成 自动 化 测试 的 各 种 复杂 需求 。 现 阶段 ， 
Seleniuml 已 经 退出 历史 舞台 ,大 部 分 Web 自动 化 测试 人 员 已 经 完全 转向 使 用 Selenium 2 
(WebDriver) 来 搭建 自己 的 自动 化 测试 框架 。 

2016 年 10 月 ,Selenium 3 诞生 。 开 发 者 在 Selenium 2 的 基础 上 做 了 很 多 了 不 起 的 工 
作 , 这 个 版 本 中 很 多 新 特性 ,主要 实现 了 把 核心 API 跟 客户 端 driver 进行 分 离 ,同时 去 掉 用 
得 越 来 越 少 的 Selenium RC 功能 。 为 了 迎合 历史 的 发 展 潮流 ,本 书 全 部 的 案例 均 基于 
Windows 7 操作 系统 上 的 Selenium 3 的 WebDriver 的 API 进行 讲解 。 


1.2 EACE EE 


> Selenium 2 (Selenium WebDriver) ; 提供 了 极 佳 的 特性 ,例如 ,面向 对 象 API, 同时 
提供 Selenium 1 的 接口 用 于 向 下 兼容 。 

> Selenium 1 (Selenium RC 或 Remote Control) :支持 更 多 的 浏览 器 ,支持 更 多 的 编程 
语言 (Java、JavaScript、Ruby、PHP,Python,Perl、C#)。 

> Selenium IDE( 集 成 开发 环境 ) : Firefox 插件 ,提供 图 形 界面 来 录制 和 回放 脚本 。 但 
此 插件 只 是 用 来 做 原型 的 工具 ,此 插件 需要 使 用 第 三 方 的 JavaScript 代码 库 才 能 支 
持 循 环 和 条 件 判断 ,并 不 希望 测试 工程 师 使 用 此 工具 来 运行 大 批量 的 测试 脚本 。 

> Selenium -Grid 可 以 在 多 个 测试 环境 以 并 发 的 方式 执行 测试 脚本 ,实现 测试 脚本 的 
并 发 执行 ,缩短 大 量 测试 脚本 的 执行 时 间 。 





I 省 Selenium 支持 的 浏览 器 和 平台 





Selenium 的 一 大 特点 就 是 能 够 在 多 种 操作 系统 上 支持 多 种 浏览 器 的 自动 化 测试 ,通过 
下 面 的 章节 我 们 可 以 了 解 到 此 工具 能 够 支持 的 操作 系统 和 浏览 器 类 型 列表 。 


1.3.1 Selenium IDE Selenium 1 和 Selenium RC 支持 的 浏览 器 和 平台 





K 1-1 列 出 了 Selenium IDE,Selenium 1 和 Selenium RC 支持 的 浏览 器 和 操作 系统 。 
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Firefox 3. x 录制 脚本 和 回放 脚本 desi Windows, Linux. Mac 
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1.3.2 Selenium 2( WebDriver) 支 持 的 浏览 器 


官网 中 并 没有 明确 列 出 WebDriver 支持 浏览 器 的 所 有 版 本 号 ,仅仅 列 出 浏览 器 的 名 
称 。 下 面 结合 笔 者 个 人 的 实际 使 用 情况 列 出 WebDriver 支持 的 浏览 器 版 本 ,请 读者 在 测试 
实践 中 进行 再 次 确认 。 

> Google Chrome, 

> IE 6/7/8/9/10/11. 

> Mac 操作 系统 的 Safari 默认 版 本 均 支 持 。 

> Firefox 的 大 部 分 版 本 。 

> Opera, 

> HtmlUnit, 

> Android 手机 操作 系统 的 默认 浏览 器 。 

> IOS 手机 操作 系统 的 默认 浏览 器 。 
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当 执行 Selenium 自动 化 测试 脚本 时 ,测试 人 员 可 以 看 到 浏览 器 中 发 生 的 神奇 一 幕 ,页 
面 上 会 自动 进行 各 种 操作 ,例如 ,打开 新 窗口 ,在 输入 框 中 输入 文字 、 寻 找 下 拉 列 表 框 等 。 测 
试 人 员 为 此 不 禁 要 多 问 一 句 :“ 它 到 底 是 怎么 实现 的 ?” 为 了 了 解 Selenium 工具 的 神奇 之 
处 ,读者 必须 深入 了 解 它 的 实现 原理 和 机 制 。 


1.4.1 Selenium RC 的 实现 原理 





Selenium RC 的 实现 原理 如 图 1-1 所 示 。 


Windows, Linux, Mac(as appropriate)... 


Safari 


Internet Explorer Firefox 


Selenium Core ] Selenium Core 















Remote 
Control Server 


+-+- Machine boundary(optional) | 


Java, Ruby, 
Python, Perl, 
PHP or .NET 





图 1-1 


Selenium 1. 0 的 自动 化 测试 执行 步骤 如 下 。 

(1) 测试 人 员 基 于 Selenium 支持 的 编程 语言 编写 好 测试 脚本 程序 。 

(2) 测试 人 员 执 行 测试 程序 。 

(3) 测试 脚本 程序 发 送 访问 网 站 的 HTTP 请 求 给 Remote Control Sever(RC)。 

(4) Remote Control Sever(RC) 收 到 请 求 后 ,访问 被 测试 网 站 并 获取 网 页 数据 内 容 , 并 
在 网 页 中 插入 Selenium Core 的 JavaScript 代码 库 ,然后 返回 给 测试 人 员 执 行 测试 的 浏 
览 器 。 

G) 测试 脚本 在 浏览 器 内 部 再 调用 Selenium Core 来 执行 测试 代码 逻辑 ,最 后 记录 测试 
的 结果 ,完成 测试 。 
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参阅 以 上 几 个 步骤 ,有 人 会 疑惑 为 什么 要 执行 第 (4) 步 ? 我 们 需要 先 学 习 一 下 浏览 器 的 
JavaScript 安全 机 制 同 源 策略 。 浏 览 器 访问 了 某 个 域名 的 网 站 后 ,浏览 器 会 打开 此 网 
站 的 网 页 ,获取 到 此 网 站 的 网 页 内 容 。 网 页 内 容 中 包含 了 要 在 网 页 里 面 执行 的 JavaScript 
语句 或 外 部 引用 的 JavaScript 文件 ,浏览 器 会 执行 属于 此 域名 下 的 JavaScript 语句 和 文件 。 
如 果 外 部 引用 的 JavaScript 文件 URL 和 当前 网 页 的 域名 不 一 致 , 那 么 浏览 器 会 拒绝 执行 此 
JavaScript 文件 中 的 代码 。 通 过 此 方式 ,浏览 器 就 可 以 防止 一 些 恶意 的 JavaScript 文件 被 加 
载 到 用 户 的 浏览 器 中 ,起 到 一 定 的 安全 防护 作用 。 

Selenium 1. 0 工具 的 核心 部 分 是 基于 JavaScript 代码 库 实现 的 ,这 个 库 肯定 默认 地 被 
测试 网 站 分 离 ,也 就 是 说 这 个 JavaScript 库 的 URL 和 被 测试 网 站 的 域名 肯定 是 不 一 致 的 。 
参阅 上 面 提 到 的 浏览 器 同 源 策 略 ,Selenium 1. 0 的 JavaScript 库 肯 定 是 被 禁止 执行 的 ,这 样 
就 无 法 实现 对 网 站 的 自动 化 测试 了 。 为 了 绕 过 浏览 器 的 安全 机 制 , Selenium 1. 0 作者 使 用 
了 代理 方法 来 解决 此 问题 ,图 1-2 更 加 详细 地 说 明了 Seleniuml. 0 代理 模式 的 实现 机 制 。 


浏览 器 
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Selenium 1. 0 代理 模式 的 实现 机 制 具体 如 下 。 

(1) 执行 测试 脚本 ,脚本 向 Selenium Server 发 起 请 求 ,要 求 和 Selenium Server 建立 
连接 。 

(2) Selenium Server 的 Launcher 启动 浏览 器 ,向 浏览 器 中 插入 Selenium Core 的 
JavaScript 代码 库 ,并 把 浏览 器 的 代理 设置 为 Selenium Server 的 HTTP Proxy. 

(3) 测试 脚本 向 Selenium Server 发 送 HTTP 请 求 ,Selenium Server 对 请 求 进 行 解析 ， 
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然后 通过 HTTP Proxy 发 送 JS 命令 通知 Selenium Core 执行 操作 浏览 器 的 动作 。 

(4) Selenium Core 接收 到 指令 后 ,执行 测试 脚本 指定 的 网 页 操作 命令 。 

(5) 浏览 器 收 到 新 的 页 面 请 求 信息 (在 第 (4) 步 中 ,Selenium Core 的 操作 可 能 引发 新 的 
页 面 请 求 ), 于 是 发 送 HTTP 请 求 给 Selenium Server 的 HTTP Proxy. 请求 新 的 Web 
页 面 。 

(6) 由 于 Selenium Server 在 启动 浏览 器 时 将 浏览 器 的 代理 访问 地 址 设置 为 Selenium 
Server 的 HTTP Proxy, 所 以 Selenium Server 会 接收 到 所 有 由 它 启动 的 浏览 器 发 送 的 请 
求 。Selenium Server 接收 到 浏览 器 发 送 的 HTTP 请 求 后 ,重组 HTTP 请 求 , 获 取 对 应 的 
Web 页 面 。 

(7) Selenium Server 的 HTTP Proxy 把 接收 到 的 Web 页 面 返 回 给 浏览 器 。 

通过 以 上 步骤 ,达到 了 将 Selenium Core 的 JavaScript 代码 库 插入 到 被 测试 网 页 的 目 
的 ,然后 就 可 以 基于 此 代码 库 在 被 测试 网 页 中 进行 各 种 自动 化 测试 操作 了 。 此 种 方式 是 一 
种 非常 巧妙 的 “欺骗 ,必须 由 衷 地 赞扬 一 下 Selenium 1.0 作者 的 聪明 智慧 。 


1.4.2 WebDriver 的 实现 原理 


WebDriver 与 之 前 Selenium 1.0 的 JavaScript 注入 实现 不 同 , 直 接 利 用 了 浏览 器 的 内 
部 接口 来 操作 浏览 器 。 对 于 不 同 平台 中 的 不 同 浏 览 器 ,必须 依赖 浏览 器 内 部 的 Native 
Component( 原 生 组 件 ) 来 实现 把 对 WebDriverAPI 调用 转化 为 对 浏览 器 内 部 接口 的 调用 。 

Selenium 1. 0 RH JavaScript 的 合成 事件 来 处 理 网 页 元 素 的 操作 ,例如 要 单 击 某 个 页 
面 元 素 , 要 先 使 用 JavaScript 定位 到 这 个 元 素 , 然 后 触发 单 击 事件 。 而 WebDriver 使 用 的 是 
系统 的 内 部 接口 或 函数 ,首先 是 找到 这 个 元 素 的 坐标 位 置 ,并 在 这 个 坐标 点 触发 一 个 鼠标 左 
键 的 单 击 操作 。 由 此 可 以 看 出 ,WebDriver 能 更 好 地 模拟 真实 的 环境 ,但 仅 能 测试 那些 可 见 
的 页 面 元 素 。 也 正 因为 这 个 区 别 , 有 些 隐藏 的 页 面 元 素 是 可 以 使 用 Selenium 1. 0 进行 操作 
的 ,而 尝试 使 用 WebDriver 单 击 的 某 个 隐藏 的 页 面 元 素 , 将 会 引发 cannot clickable 的 错误 
提示 信息 。 


1.4.3 Selenium 1.0 和 WebDriver 的 特点 











1. Selenium 1.0 的 缺点 


(1) 无 法 调用 和 触发 本 机 的 键盘 和 鼠标 事件 。 

(2) 由 于 浏览 器 的 同 源 策略 ,只 能 使 用 插入 JavaScript 方式 来 进行 模拟 网 页 操作 的 
测试 。 

G) 无 法 处 理 基 本 身份 认证 、 自 签名 的 证 书 以 及 文件 上 传 /下 载 的 框 体 。 

2. Selenium 2(WebDriver) 的 优点 

(1) Selenium 必须 操作 真实 浏览 器 ,但 WebDriver 却 可 以 使 用 HTMLUnit 进行 测试 ， 
在 不 打开 浏览 器 的 情况 下 进行 快速 测试 。 

(2) WebDriver 基于 浏览 器 的 内 部 接口 来 实现 自动 化 测试 ,更 接近 用 户 使 用 的 真实 
情况 。 

(3) WebDriver 提供 了 更 简洁 的 面向 对 象 API, 提 高 了 测试 脚本 的 编写 效率 。 
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(4) WebDriver 在 使 用 过 程 中 无 须 单独 启动 Selenium Server。 


1.5 EACE: SEES AE 


Selenium 3 将 以 开发 一 款 聚 焦 于 Web 端 和 移动 端的 自动 化 测试 工具 为 目标 ， 
WedDriver API 是 Selenium 2 的 主要 插件 ,Selenium 3 依然 沿用 ,并 且 现 在 是 基于 W3C 标 
WE. Selenium 会 不 断 扩 充 WebDriver API, 提 供 移 动 端的 测试 套件 ,以 提高 不 同 项 目 间 的 互 
操作 性 。Selenium 3 同时 也 更 关注 系统 的 稳定 性 , 移 除 原始 的 Selenium 核心 实现 ,丢弃 
Selenium RC API。 相 比 Selenium 2.Selenium 3 新 特性 如 下 。 

(1) Selenium 3 去 掉 了 Selenium RC ,这 是 Selenium 3 最 大 的 变化 。 

(2) Selenium 3 只 支持 Java 8 及 以 上 版 本 。 

(3) Selenium 3 不 再 提供 默认 浏览 器 支持 ,所 有 支持 的 浏览 器 均 由 浏览 器 官方 提供 支 
持 , 也 就 是 由 官方 提供 相应 的 driver 进行 支持 ,由 此 提高 了 自动 化 测试 的 稳定 性 。Selenium 
3.0 以 前 版 本 能 直接 启动 Firefox 浏览 器 ,而 Selenium 3. 0 版 本 开始 需要 下 载 Firefox 官方 
提供 的 geckodriver 驱动 才能 启动 Firefox 浏览 器 ,并 且 Firefox 浏览 器 必须 是 48 版 本 以 上 。 

(4) Selenium 3 通过 Apple 自己 的 safaridriver 支持 MacOS 上 的 Safari 浏览 器 。Safari 
浏览 器 的 驱动 直接 被 集成 到 Selenium Server 上 ,也 就 是 说 想 在 Safari 浏览 器 上 执行 自动 化 
测试 脚本 ,必须 使 用 Selenium Server, 

(5) Selenium 3 通过 Microsoft 官方 提供 的 MicrosoftWebDriver 支持 Edge 浏览 器 。 
由 此 在 Windows 10 系统 中 就 可 以 实现 Edge 浏览 器 自动 化 测试 ,只 需要 在 https:// 
developer. microsoft. com/en-us/microsoft-edge/tools/webdriver/ 网 址 下 载 相 应 版 本 的 驱 
动 程序 即 可 实现 。 

(6) Selenium 3 只 提供 支持 TE 9. 0 及 以 上 版 本 ,早期 版 本 也 许 还 能 工作 ,但 不 再 提供 
支持 。 

Selenium 3 让 Web 自动 化 测试 运行 更 稳定 ,性 能 更 高 ,支持 的 浏览 器 更 多 更新。 


COL 自动 化 测试 那 点 事 儿 


虽然 很 多 测试 工程 师 都 了 解 一 些 “ 自 动 化 测试 的 知识 ,但 是 鲜 有 人 能 够 准确 地 回答 如 
下 问题 ， 

» 在 自动 化 实施 的 过 程 中 应 该 如 何 设 定 自动 化 测试 的 目标 ? 

> 如 何 衡量 自动 化 测试 的 投入 产 出 比 ? 

> 需要 什么 样 的 人 员 分 工 ? 

> 自动 化 测试 的 最 佳 实践 是 什么 ? 

要 想 知道 上 面 问题 的 答案 ,请 仔细 阅读 本 章 内 容 , 它 其 实 比 你 搭建 一 个 自动 化 测试 框架 
的 意义 还 要 大 。 


2.1 MEE AM z Eos 


我 们 做 任何 事情 都 应 该 有 个 目的 ,有 了 目的 就 会 产生 一 个 对 应 的 目标 ,然后 再 基于 这 个 
目标 进行 相关 活动 的 实施 ,以 此 来 达到 目的 。 类 似 地 ,我 们 在 进行 自动 化 实施 的 时 候 , 首 先 
要 明确 自动 化 测试 的 目标 , 即 实现 了 自动 化 测试 到 底 能 为 我 们 带 来 什么 好 处 ,解决 了 什么 问 
题 ? 我 们 不 能 为 了 自动 化 而 自动 化 ,必须 在 实施 自动 化 测试 之 前 明确 自动 化 测试 的 目标 。 

笔者 基于 多 年 的 自动 化 测试 实践 ,下面 列 出 一 些 相对 通用 的 自动 化 测试 目标 。 

(1) 提高 测试 人 员 的 工作 成 就 感 和 幸福 感 ,减少 手工 测试 中 的 重复 性 工作 。 

目前 ,在 中 国 的 大 部 分 中 小 企业 中 ,手工 测试 占 日 常 测试 工作 的 大 部 分 比例 ,测试 人 员 
必须 跟随 开发 团队 一 起 不 断 地 进行 迭代 式 开 发 和 测试 ,一 个 功能 模块 可 能 在 整个 开发 周期 
中 被 重复 测试 超过 10 次 以 上 .测试 人 员 在 执行 了 如 此 多 的 重复 工作 之 后 ,常常 会 对 于 “IT 
民工 ”这 个 词 有 着 更 加 深刻 的 理解 。 

如 何 改变 这 个 现状 呢 ? 使 用 自动 化 测试 肯定 是 个 很 好 的 选择 ,脚本 写 好 以 后 ,可 以 不 断 
地 重复 运行 ,测试 人 员 只 需要 单 击 按钮 就 可 以 开始 测试 工作 了 ,然后 去 喝 喝 茶 看 看 报纸 ,一 
会 儿 回来 看 一 下 测试 结果 ,就 完成 了 以 往 需 要 手工 测试 花费 很 长 时 间 的 工作 。 测 试 工作 的 
成 就 感 和 幸福 感 油 然而 生 ,测试 人 员 也 会 有 精力 和 意愿 去 主动 地 推进 自动 化 测试 在 不 同 项 
目 中 的 深入 实施 。 

如 何 验 证 达到 了 此 目的 呢 ? 可 以 通过 测试 人 员 的 满意 度 调 查 来 判定 是 否 提高 了 测试 人 
员 的 成 就 感 和 满意 度 。 

(2) 提高 测试 用 例 的 执行 效率 ,实现 快速 的 自动 化 回归 测试 ,快速 地 给 开发 团队 质量 





x 
E 


使 用 手工 方式 来 执行 测试 用 例 ,速度 必然 是 很 慢 的 。 人 是 一 种 生物 ,不 是 机 器 ,工作 时 
间 长 了 必然 会 觉得 劳累 ,测试 执行 的 速度 自然 地 就 慢 下 来 了 ,在 测试 用 例 非常 多 的 情况 下 ， 
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完整 地 测试 一 遍 所 有 测试 用 例 的 时 间 成 本 就 会 相当 高 了 。 

使 用 自动 化 测试 取代 手工 测试 ,那么 测试 用 例 的 执行 者 就 变 成 了 机 器 执行 ,机 器 可 以 
24 小 时 不 停 地 执行 , 它 可 以 毫 无 怨言 .不知 疲 倦 地 快速 完成 测试 脚本 指派 给 它 的 测试 任务 。 
此 种 方式 势必 可 以 大 大 提高 测试 执行 的 效率 ,减少 测试 用 例 的 执行 时 间 ,提高 测试 执行 的 准 
确 性 。 

目前 ,敏捷 开发 模式 也 在 各 类 软件 企业 中 开始 普及 和 应 用 。 敏 捷 开 发 对 于 被 开发 产品 
的 质量 反馈 有 着 很 高 的 要 求 ,需要 每 星期 甚至 每 天 开发 出 一 个 build 版 本 ,并 且 部 署 在 测试 
环境 上 ,希望 测试 人 员 能 够 给 出 快速 的 质量 反馈 。 目 前 ,只 有 通过 自动 化 测试 的 方式 才能 真 
正 实现 对 于 大 型 敏捷 开发 项 目 快速 的 质量 反馈 需求 ,缺少 自动 化 测试 的 敏捷 开发 项 目 会 大 
大 增加 项 目 失 败 的 风险 。 

如 何 验证 达到 了 此 目的 呢 ? 可 以 和 以 前 手工 测试 的 执行 时 间 进 行 比 对 ,看 看 是 否 明显 
缩短 了 测试 用 例 的 执行 时 间 ,询问 开发 人 员 项 目的 质量 反馈 速度 是 否 为 快速 地 发 布 产品 带 
来 很 大 帮助 。 

(3) 减少 测试 人 员 的 数量 ,提高 开发 和 测试 的 比例 ,节省 企业 的 人 力 成 本 。 

在 大 部 分 IT 企业 的 运营 成 本 中 ,差不多 50 欠 一 70 儿 的 成 本 是 人 工 成 本 ,如 何 能 够 更 好 
地 控制 人 工 成 本 ,对 于 企业 的 发 展 有 着 重要 作用 。 使 用 自动 化 测试 方式 ,势必 会 减少 手工 测 
试 的 工作 量 , 从 而 达到 减少 测试 人 员 的 目的 ,进而 降低 企业 的 人 工 成 本 ,增强 企业 的 盘 利 
能 力 。 

如 何 验证 达到 了 此 目的 呢 ? 在 相同 级 别 测试 工作 量 的 情况 下 ,企业 可 以 测算 在 使 用 自 
动 化 测试 后 ,项 目 中 是 否 减少 了 测试 人 员 投 入 数量 和 工作 时 长 。 

(4) 在 线 产品 的 运行 状态 监控 。 

在 完成 产品 开发 和 测试 工作 后 ,产品 会 被 发 布 到 生产 环境 ,正式 地 为 用 户 提 供 服务 。 但 
是 产品 在 生产 环境 的 运营 过 程 中 ,总 是 会 由 于 各 类 原因 造成 这 样 或 者 那样 的 运行 问题 或 故 
障 。 如 何 来 快速 地 发 现 这 样 的 问题 呢 ? 有 人 说 “出 了 问题 一 定 会 有 用 户 给 客服 打 电 话 进行 
投诉 的 ,那么 我 们 就 可 以 发 现 生产 环境 中 的 问题 了 ”。 如 果 采 用 这 样 的 处 理 方式 ,势必 会 降 
低 用 户 对 于 产品 使 用 的 满意 度 。 另 外 ,如 果 没 有 热心 的 用 户 进行 投诉 ,那么 生产 环境 问题 被 
发 现 的 时 间 会 被 大 大 推迟 ,所 以 依靠 客户 投诉 的 方式 是 不 可 取 的 。 

为 了 保证 快速 及 时 地 发 现 生产 环 境 的 不 定期 问题 ,建议 采用 拨 测 的 方式 来 监控 产品 的 
运行 状态 ,可 以 编写 自动 化 测试 脚本 测试 产品 的 主要 功能 逻辑 ,定时 去 运行 测试 脚本 检查 产 
品系 统 是 否 依旧 可 以 正常 工作 ,如 果 运 行 测试 脚本 后 没有 发 现任 何 的 问题 , 则 休眠 等 待 一 段 
时 间 后 再 运行 测试 脚本 检测 产品 系统 的 运行 状态 。 如 果 测 试 脚本 发 现 了 产品 系统 的 运行 问 
题 ,在 重 试 几 次 之 后 确认 产品 系统 的 问题 依旧 存在 , 则 测试 脚本 会 自动 发 出 报警 邮件 和 短信 
给 系统 运 维 的 值班 人 员 进 行 系统 报警 .相关 人 员 收 到 报警 后 可 以 人 工 去 处 理 系 统 出 现 的 运 
行 故障 ,这 样 就 达到 实时 监控 产品 系统 的 目的 ,实现 在 第 一 时 间 发 现 和 处 理 系统 的 故障 。 

如 何 验证 达到 了 此 目的 呢 ? 在 生产 环境 运行 的 产品 系统 出 现 问题 , 则 系统 可 以 在 几 分 
钟 内 实现 自动 报警 给 相关 人 员 。 

(5) 插入 大 量 测 试 数据 。 

在 系统 级 别 的 测试 过 程 中 ,经 常 要 插入 大 量 的 测试 数据 来 验证 系统 的 处 理 能 力 ,例如 测 
试 人 员 想 要 插入 100 个 注册 用 户 ,并 且 每 个 用 户 都 有 特定 的 10 条 用 户 数据 ,那么 需要 插入 
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的 数据 量 足 有 1000 条 之 多 ,使 用 手工 的 方式 来 插入 这 些 数据 势必 会 花费 很 长 的 时 间 和 很 大 
的 精力 。 测 试 人 员 可 以 通过 三 种 自动 化 的 方式 来 实现 上 述 测试 数据 插入 要 求 。 

第 一 种 方式 :测试 人 员 编 写 数据 库 的 存储 过 程 脚本 ,在 数据 库 的 不 同 数据 表 中 插 人 测试 
数据 ,使 用 这 样 的 方式 可 以 实现 海量 数据 的 快速 插入 。 当 然 此 方式 也 有 缺点 ,如 果 搞 不 清楚 
数据 库 中 各 个 表 的 逻辑 关系 和 数据 格式 的 插入 要 求 ,很 可 能 插入 错误 数据 ,导致 无 法 被 前 台 
的 程序 所 正确 展示 和 使 用 。 

第 二 种 方式 : 按照 系统 接口 的 调用 规范 要 求 , 在 测试 系统 的 接口 层 编写 测试 脚本 调 
用 插入 数据 的 系统 接口 ,实现 测试 数据 的 快速 插入 ,速度 虽然 不 一 定 有 第 一 种 方式 快 , 但 
是 能 够 基本 保证 插入 数据 的 正确 性 。 如 果 被 测试 系统 没有 接口 层 , 那 么 此 方式 就 无 法 实 
施 了 。 

第 三 种 方式 : 使 用 前 台 的 自动 化 测试 工具 ,在 系统 的 前 台 界 面 模拟 用 户 的 真实 操作 行 
为 来 输入 各 类 测试 数据 ,然后 再 提交 到 测试 系统 中 。 此 方式 的 优点 是 可 以 真正 模拟 用 户 插 
入 数据 的 行为 ,保证 数据 插入 的 准确 性 和 完整 性 ,包含 前 台 界面 的 系统 均 可 使 用 此 方式 。 此 
方式 的 缺点 是 插入 数据 的 速度 要 比 前 两 种 方式 慢 很 多 。 

针对 被 测试 系统 的 实际 情况 ,测试 人 员 可 以 使 用 以 上 三 种 方式 之 一 实现 测试 数据 的 插 
入 需求 。 

(6) 常见 的 错误 目标 : 使 用 自动 化 完全 替代 手工 测试 ,使 用 自动 化 测试 发 现 更 多 的 
新 bug。 

很 多 测试 人 员 都 有 一 个 错误 的 想法 ,就 是 想 用 自动 化 测试 完全 替代 手工 测试 ,如 果 设 定 
此 目标 则 会 让 自动 化 测试 的 实施 带 来 极 大 的 困难 。 测 试 工作 本 身 就 是 一 种 艺术 ,需要 使 用 
测试 人 员 的 智慧 去 探索 系统 中 可 能 出 现 的 问题 ,并 且 需 要 在 测试 过 程 中 使 用 不 同 的 测试 方 
法 ,测试 数据 和 测试 策略 来 发 现 更 多 问题 。 而 自动 化 测试 的 实施 方式 则 是 使 用 固定 的 方法 

固定 数据 去 实施 测试 ,无 法 像 人 一 样 根据 测试 系统 的 响应 情况 作出 及 时 的 测试 策略 调整 ， 
势必 会 造成 测试 逻辑 的 低 覆 盖 率 。 另 外 ,测试 用 例 中 有 很 多 异常 操作 很 难 使 用 程序 来 进行 
模拟 , 若 要 完全 实现 自动 化 测试 来 模拟 则 会 带 来 极 大 的 技术 难度 挑战 。 所 以 ,只 要 设 定 自 动 
化 测试 能 够 替代 一 定 比 例 的 手工 测试 工作 为 目标 即 可 ,万 不 可 对 自动 化 测试 的 覆盖 度 设 定 
过 高 的 比例 要 求 。 

还 有 的 测试 人 员 期 望 使 用 自动 化 测试 来 发 现 更 多 的 新 bug, 这 个 也 是 一 个 常见 误区 。 
虽然 在 编写 自动 化 测试 用 例 的 过 程 中 会 发 现 大 部 分 的 bug. pnp 
是 用 来 发 现 新 bug 的 ,而 是 用 来 验证 以 前 能 够 正常 工作 的 功能 是 否 依旧 可 以 正常 工作 的 。 
举 一 个 例子 ,一 个 被 测试 系统 有 100 个 功能 点 ,由 5 万 行 代码 来 实现 ,这 100 个 功能 在 上 一 
个 版 本 中 均 通过 测试 ,在 下 一 个 迭代 的 版 本 开发 中 ,程序 员 根 据 产品 人 员 的 5 个 新 需求 修改 
了 5 个 复杂 的 功能 点 ,并且 新 增 和 修改 了 500 行 代码 ,那么 测试 人 员 针对 这 样 的 场景 如 何 来 
测试 这 个 版 本 的 产品 呢 ? 因为 测试 人 员 不 知道 被 修改 的 500 行 代码 到 底 会 怎样 影响 整体 的 
100 个 功能 点 ,所 以 只 能 把 100 个 功能 点 都 测试 一 遍 才能 放心 地 让 这 个 版 本 进行 发 布 和 上 
线 。100 个 功能 点 的 测试 工作 量 就 这 样 产 生 了 ,如 果 采 用 手工 测试 的 方式 , 则 测试 用 例 的 执 
行 周期 肯定 会 是 个 很 长 的 周期 ,并 且 测 试 人 员 发 现 了 新 bug 后 ,程序 员 又 修改 了 100 行 代 
码 , 那 么 是 不 是 又 要 重新 测试 这 100 个 功能 点 呢 ?” 如 果 再 次 测试 ,那么 测试 人 员 就 陷入 了 周 
而 复 始 的 重复 劳动 中 ,如 果 不 测试 全 部 100 个 功能 点 ,那么 被 修改 代码 产生 的 不 确定 性 又 难 
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以 得 到 评估 。 如 果 测 试 人 员 拥 有 了 这 100 个 功能 点 的 自动 化 测试 脚本 ,就 不 会 出 现 进退 两 
难 的 境地 了 ,测试 人 员 可 以 使 用 自动 化 测试 脚本 快速 验证 原 有 的 95 个 功能 点 是 否 正 常 工 
作 。 自 动 化 测试 可 以 大 大 降低 手工 测试 的 重复 性 ,测试 人 员 只 要 手工 测试 5 个 被 修改 的 功 
能 即 可 。 测试 人 员 充 分 测试 这 5 个 功能 点 并 确认 没有 bug 产生 后 ,可 以 新 增 编写 这 5 个 功 
能 点 的 自动 化 测试 用 例 , 用 于 下 一 个 版 本 的 自动 化 测试 即 可 。 从 上 例 可 以 看 出 ,自动 化 测试 
更 适合 用 于 回归 测试 ,而 不 是 用 来 发 现 新 bug。 

基于 以 上 6 个 常见 的 自动 化 测试 目标 ,测试 人 员 应 根据 测试 项 目的 具体 要 求 正 确 地 设 
定 自动 化 测试 目标 。 


2.2 a: Ee 


在 一 个 企业 中 推广 自动 化 测试 是 一 件 非 常 困难 的 任务 ,因为 打破 旧 有 的 手工 测试 习惯 、 
工作 模式 和 工作 流程 ,必然 会 让 整个 开发 和 测试 团队 有 不 适应 的 地 方 , 难 免 会 遇 到 各 种 的 抵 
制 .不 理解 和 不 合作 。 若 能 够 借助 高 层 的 力量 ,那么 自动 化 测试 的 推广 工作 势必 会 事 半 功 
音 。 如 果 想 在 企业 中 推广 自动 化 测试 ,首先 要 寻求 高 层 的 支持 ,让 高 层 管理 人 员 在 开发 和 测 
试 团队 中 强调 自动 化 测试 的 意义 和 实施 目标 ,并 要 求 公司 和 团队 给 予 必要 的 资源 和 时 间 支 
持 。 缺 乏 高 层 的 支持 ,自动 化 测试 的 推广 基本 上 会 无 疾 而 终 。 

在 自动 化 测试 的 实施 过 程 中 ,要 先 选择 合适 的 项 目 进行 试点 实施 ,建议 选择 开发 进度 不 
太 紧 张 , 且 产 品 需 求 相对 稳定 的 项 目 进行 实施 。 在 实施 过 程 中 ,要 合理 地 设 定 自动 化 测试 的 
实施 目标 ,并 争取 在 实施 结束 后 实现 目标 。 将 试点 项 目的 自动 化 测试 成 果 汇 报 给 相关 管理 
层 , 让 他 们 进一步 理解 自动 化 测试 的 意义 、 成 果 和 作用 。 基 于 试点 项 目的 杰出 成 果 , 让 管理 
层 再 进行 其 他 项 目的 宣 贯 和 推广 ,逐步 地 在 全 公司 开展 自动 化 测试 工作 。 


2.3 Kos udo 


大 部 分 软件 企业 或 互联 网 企业 的 经 营 都 是 为 了 谋取 尽 可 能 多 的 利润 ,它们 都 希望 投入 
尽 可 能 少 的 成 本 来 获取 尽 可 能 多 的 利润 ,所 以 要 从 这 个 角度 来 谈 一 下 自动 化 测试 的 投入 产 
出 比 问题 。 

在 尝试 自动 化 测试 实践 时 ,测试 团队 需要 分 析 投 入 哪些 资源 ,例如 技术 人 员 的 工时 投 
入 ,购买 相关 软件 版 权 的 费用 、 机 柜 、 带 宽 和 服务 器 的 投入 等 ,需要 列 出 具体 的 资源 需求 列 
表 。 结 合 项 目的 实际 情况 ,测试 团队 评估 自动 化 测试 的 短期 目标 和 长 期 目标 ,并 描述 出 可 能 
获取 到 的 收益 ,再 提交 给 研发 团队 的 管理 层 进行 投入 产 出 比 评估 。 若 管理 层 认 为 投入 产 出 
比比 较 高 ,那么 就 可 以 开始 实施 工作 了 ,如果 觉 得 不 高 , 则 很 可 能 无 法 进行 实施 。 

建议 测试 团队 要 从 以 下 几 个 方面 考虑 自动 化 测试 的 成 本 投入 : 

CD 项 目 本 身 是 否 适合 实施 自动 化 测试 ,测试 脚本 的 编写 和 维护 成 本 是 否 较 高 ? 

CD 现 有 测试 团队 成 员 是 否 具备 自动 化 测试 的 实施 能 力 ?” 如 果 不 具 备 ,是 否 可 以 采 
音 训 的 方式 来 提升 ,还 是 进行 外 部 招聘 有 能 力 的 自动 化 测试 实施 人 员 ? 

(3) 使 用 何 种 自动 化 测试 软件 ,是 否 需 要 购买 版 权 ? 

(4) 现 有 的 测试 环境 硬件 要 求 是 否 符合 自动 化 测试 的 实施 要 求 ? 
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O 研发 团队 管理 层 对 于 自动 化 测试 的 潜在 期 望 和 要 求 ? 

建议 测试 团队 要 从 以 下 几 个 方面 中 重点 考虑 自动 化 测试 的 产 出 。 

CD 短期 和 长 期 来 分 析 能 够 节省 多 少 测试 人 力 资源 的 投入 ? 

D 是 否 能 够 开发 出 比较 成 熟 的 自动 化 测试 框架 ,解决 测试 脚本 编写 和 维护 成 本 高 的 
问题 ? 

(3) 自动 化 测试 脚本 是 否 可 以 快速 地 被 执行 ,并 确认 具体 量化 指标 ? 

(4) 自动 化 测试 的 引入 是 否 会 提高 开发 人 员 的 开发 效率 和 质量 ,并 确认 具体 量化 指标 ? 


2.4 敏捷 开发 中 的 自动 化 测试 应 用 


目前 ,敏捷 开发 模式 已 经 在 国内 众多 的 开发 团队 中 盛行 ,开发 团队 已 经 逐步 享受 到 敏捷 
开发 带 来 的 高 效 和 价值 ,其 中 敏捷 团队 全 员 的 质量 负责 方式 和 大 规模 的 自动 化 测试 引入 成 
为 现在 的 热度 话题 。 敏 捷 开发 的 本 质 到 底 是 什么 呢 ? 为 什么 大 家 开始 高 度 认可 它 的 价值 
呢 ? 本 节 我 们 做 一 个 简单 的 解释 说 明 。 

首先 ,我 们 先 来 看 传统 开发 模式 遇 到 的 问题 ,以 往 传统 的 开发 模式 大 部 分 都 是 按照 长 周 
期 和 里 程 碑 的 方式 进行 管理 的 ,有 明确 的 需求 ,设计 、 开 发 ,测试 和 上 线 的 几 个 阶段 ,产品 的 
发 布 周期 也 比较 长 ,一 般 2 一 3 个 月 ,长 的 甚至 有 1 一 2 年 的 时 间 。 虽 然 每 个 阶段 都 有 明确 的 
目标 和 工作 范围 ,但 是 令 人 困扰 的 是 需求 总 是 在 不 断 地 产生 变化 ,不 断 影 响 项 目的 设计 、 开 
发 ,测试 等 多 个 阶段 ,导致 项 目 设计 人 员 在 初期 就 要 想 办 法 做 出 各 种 元 余 的 系统 设计 来 防止 
未 来 变更 的 需求 带 来 的 负面 影响 。 然 而 ,计划 总 是 赶不上 变化 ,需求 的 变化 和 不 确定 性 依然 
会 带 来 各 种 问题 ,导致 项 目 被 不 断 地 延迟 ,团队 成 员 也 越 来 越 抵制 需求 的 变更 ,项 目 质量 也 
会 不 断 下 降 , 对 于 大 型 项 目 来 说 总 是 危机 重重 。 

敏捷 开发 和 传统 开发 模式 完全 不 同 , 它 只 会 实现 明确 的 需求 ,拥抱 变化 ,使 用 自动 化 测 
试 和 重 构 的 方式 来 响应 不 断 变 化 的 需求 ,实现 每 月 、 每 周 甚至 每 天 发 布 新 版 本 ,解决 传统 开 
发 模式 的 很 多 问题 。 

敏捷 开发 的 核心 理念 是 小 步 快 跑 , 它 具有 如 下 6 个 特点 。 

(1) 鼓励 团队 成 员 的 面对面 沟通 ,敏捷 开发 模式 认为 人 和 人 的 相互 交流 胜 于 任何 流程 
和 工具 。 

(2) 客户 协作 胜 过 合同 谈判 。 

(3) 把 工作 重点 放 在 可 执行 的 程序 上 ,而 不 是 写 大 量 的 文档 。 

(4) 团队 协作 和 团队 激励 ,团队 对 产品 的 发 布 承担 责任 ,明确 团队 的 统一 目标 。 

C5) 响应 变化 胜 过 遵循 计划 。 

C6) 使 用 持续 集成 和 自动 化 测试 方式 快速 反馈 项 目 质量 ,及 时 地 适应 新 的 需求 ,保证 产 
品 的 正确 性 。 

其 中 ,自动 化 测试 是 敏捷 开发 中 很 重要 的 一 个 环节 ,因为 敏捷 开发 模式 一 般 会 在 每 天 提 
交 开 发 的 代码 到 代码 版 本 控制 系统 ,为 了 保证 所 有 提交 的 代码 都 是 正确 的 ,开发 团队 通常 都 
会 使 用 自动 化 测试 手段 来 进行 回归 测试 ,验证 所 有 代码 修改 没有 影响 到 以 前 版 本 的 功能 。 
通过 自动 化 测试 手段 ,开发 团队 可 以 实现 每 日 代码 集成 的 开发 任务 ,并 保证 每 天 的 代码 开发 
质量 。 自 动 化 测试 是 敏捷 开发 模式 的 基础 ,如 果 缺 少 自动 化 测试 ,那么 敏捷 测试 通常 会 失 
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败 , 因 为 项 目 本 身 无 法 控制 持续 集成 过 程 中 出 现 的 代码 修改 风险 ,也 无 法 对 项 目的 不 断 重 构 
提供 快速 测试 的 支持 ,势必 会 引发 项 目 延 期 \ 质 量 下 降 等 一 系列 问题 ,无 法 真正 实现 小 步 快 
跑 的 目标 。 

敏捷 开发 中 通常 使 用 测试 驱动 开发 的 方法 ,这 种 方法 不 同 于 传统 软件 开发 流程 的 开发 
方法 ,要 求 在 编写 某 个 功能 的 代码 之 前 先 编写 测试 代码 ,开发 人 员 只 编写 使 测试 通过 的 功能 
代码 ,通过 测试 来 推动 整个 开发 的 进行 ,此 方式 可 以 确保 开发 人 员 集 中 精力 在 明确 的 需求 
上 ,防止 过 度 设计 , 尽 可 能 保持 代码 的 简洁 性 ,提高 开发 效率 。 

还 有 一 种 敏捷 开发 中 常用 的 技术 就 是 行为 驱动 开发 (Behavior-Driven Development， 
BDD). BDD 是 测试 驱动 开发 的 进化 ,可 以 有 效 地 改善 设计 ,并 在 系统 的 演化 过 程 中 为 团队 
指明 前 进 方向 。BDD 使 用 客户 和 开发 者 通用 的 语言 来 定义 系统 的 行为 ,从 而 做 出 符合 客户 
需求 的 设计 ,避免 其 他 开发 模式 中 常见 的 客户 和 开发 双方 对 于 需求 理解 的 不 一 致 性 。 

敏捷 开发 中 的 测试 可 以 从 图 2-1 所 示 的 三 个 层级 进行 。 








图 2-1 


图 2-1 是 一 个 三 角形 的 示意 图 ,三 层 中 的 每 一 层 区 域 大 小 代表 着 每 一 个 层级 测试 的 收 
益 大 小 ,我 们 可 以 看 出 单元 测试 的 收益 是 最 大 的 ,接口 测试 其 次 ,UI 测试 的 收益 最 小 。 单 元 
测试 的 颗粒 度 是 最 小 的 ,测试 范围 集中 在 类 和 方法 ,测试 用 例 编写 相对 简单 ,并 且 出 现 bug 
后 ,定位 问题 相对 快速 ,可 以 在 开发 初期 发 现 大 部 分 问题 ,并 且 单 元 测试 执行 的 速度 最 快 , 通 
常 在 毫秒 级 别 运行 就 可 以 得 到 测试 结果 。 接 口 测试 的 颗粒 度 更 粗 了 一 些 , 测 试 范围 集中 在 
模块 、 子 模块 间 的 数据 交互 ,定位 问题 相对 复杂 ,涉及 分 析 的 代码 量 很 大 ,测试 执行 速度 也 比 
单元 测试 慢 许多 。UI 测试 的 收益 最 小 ,测试 通常 在 系统 测试 和 验收 测试 阶段 中 进行 ,基于 
全 部 的 系统 代码 进行 测试 ,测试 出 现 问题 后 定位 和 分 析 困 难 。UI 测试 通常 在 用 户 使 用 的 界 
面 进行 ,测试 执行 相对 于 单元 测试 和 接口 测试 慢 很 多 ,并 且 因 为 UT 界面 经 常 发 生变 化 和 调 
整 , 自 动 化 执行 和 维护 成 本 也 很 高 。 

敏捷 开发 中 的 自动 化 测试 可 以 基于 这 三 种 方式 进行 ,基于 上 述 的 收益 说 明 ,敏捷 测试 更 
鼓励 在 单元 测试 和 接口 测试 上 投入 更 多 资源 ,以 此 来 实现 快速 编写 ,快速 执行 .快速 定位 问 
题 的 测试 目的 ,能 够 快速 地 给 予 项 目 质量 反馈 。UI 测试 虽然 相对 来 说 收益 最 低 ,但 是 UT 
层 对 于 用 户 来 说 是 最 直观 的 感知 ,所 以 也 要 在 这 个 层级 实现 一 定 程度 的 自动 化 测试 , 尽 可 能 
模拟 用 户 的 各 种 真实 操作 ,确保 用 户 的 最 佳 产品 体验 。 
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自动 化 测试 人 员 分 工 


自动 化 测试 通常 涉及 三 种 分 工 角色 : 

(1) 测试 框架 开发 人 员 。 

(2) 基于 测试 框架 编写 测试 脚本 的 人 员 。 

(3) 编写 需要 自动 化 测试 用 例 以 及 测试 框架 需求 的 人 员 。 

三 种 角色 可 以 根据 测试 团队 人 员 的 实际 水 平 进行 角色 合并 ,通常 情况 下 测试 开发 人 员 
承担 第 一 种 和 第 二 种 角色 , 非 测试 开发 人 员 承 担 第 三 种 角色 。 测 试 框架 搭建 人 员 的 技术 能 
力 要 求 最 高 ,通常 在 人 才 市 场 上 处 于 非常 抢手 的 情况 ,优秀 的 测试 开发 人 员 年 薪 一 般 在 
20 一 30 万 元 ,并 且 他 们 的 职业 发 展 空间 比 传统 的 手工 测试 更 大 ,更 容易 上 升 到 测试 团队 的 
管理 层 。 





2.6 MERKAN- IE Rz 













一 个 适合 测试 团队 使 用 的 自动 化 测试 工具 ,优秀 的 测 
半 功 售 , 反 之 则 可 能 给 自动 化 测试 的 实施 工作 带 来 灭 
慎 态 度 ,需要 结合 工具 特点 和 测试 团队 的 实际 情况 进 
lA JH RACER AEN A-T UE SN REHAB SORA TR. 





A 2-1 列 出 选择 自动 化 测试 工具 时 需要 考虑 的 关键 点 。 
表 2-1 





是 否 支 持 持 | 工具 运行 的 
续集 成 工具 | 稳定 性 


根据 团队 成 员 | 评估 是 否 易 | 是 否 可 以 在 





支 
的 编程 语言 





工具 特点 | 收费 /开源 工具 学 习 成 本 








队 是 否 
团队 是 否 有 预 | 团队 成 员 是 否 | 是 理 满足 被 














算 购 买 ? 团队 能 力 评估 工具 | 于 和 持续 集 | 无 人 值守 状 
队 具备 相关 编程 | 测试 对 象 的 
IMPR naque ME | 学 习 的 时 间 成 | 成 工具 进行 | S FB 
试 工具 的 能 力 ?| ”| 本 和 人 工 成 本 | 集成 ? 间断 运行 ? 





2.6.2 Selenium WebDriver 和 QTP 工具 的 特点 比较 





目前 ,主流 的 Web 自动 化 测试 工具 是 Selenium WebDriver 和 QTP, 下 面 详细 比较 一 下 
这 两 种 工具 的 特点 ,如 表 2-2 所 示 。 











表 2-2 
t € 项 X oH 
Selenium: 在 浏览 器 后 台 执行 ,执行 时 可 以 最 小 化 ,可 以 在 一 台 机 器 上 同时 执行 
用 户 仿真 多 个 测试 
QTP: 完全 模拟 终端 用 户 , 独 占 屏幕 ,只 能 开启 一 个 独占 的 实例 
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续 表 
比 较 项 说 朋 
- Selenium; 支持 主要 的 组 件 ,但 是 某 些 事件 .方法 和 对 象 属性 的 支持 不 够 
J 元 素 组 件 的 支持 
CI 元素 组 件 的 支持 os 良好 的 支持 ,提供 对 .NET 组 件 的 支持 
Selenium: 需要 自 写 代码 实现 ,相对 复杂 
UI 对 管 UH 
对 象 的 管理 和 支持 | QTP. 做 了 很 好 的 支持 ,支持 录制 添加 
Selenium; 只 支持 一 部 分 浏览 器 的 弹出 框 ,需要 调用 其 他 第 三 方 工具 来 进行 操作 
对 E E 
TENER QTP ERA 
Selenium, 支持 多 种 主流 浏览 器 IE, Firefox, Chrome, Opera 和 Safari 
览 E 
MASNER QTP. 只 支持 IE 和 Firefox 
面向 对 象 语言 和 扩展 | Selenium: 支持 多 种 编程 语言 和 外 部 库 Java Python C£ 等 
性 支持 QTP: 只 能 使 用 VBScript 编写 脚本 ,不 支持 其 他 语言 和 外 部 库 





支持 的 操作 系统 / 
平台 


Selenium :支持 跨 平台 





QTP: 只 支持 Windows 





Selenium :创建 脚本 相对 困难 














HERRA QTP. OENAR TR 

Selenium :免费 
RREN QTP: 按 照 安 装 的 机 器 台数 计 费 ,版 权 费 用 昂贵 
持续 集成 工具 Selenium :支持 主流 的 持续 集成 工具 








QTP: 不 支持 


综 上 因素 比较 ,具备 一 定编 程 能 力 的 测试 团队 更 适合 选择 Selenium WebDriver 作为 团 
队 的 主要 Web 自动 化 测试 工具 ,对 于 预算 充裕 且 团 队 成 员 编 程 能 力 一 般 的 测试 团队 更 适合 
选择 QTP 工具 作为 团队 的 主要 Web 自动 化 测试 工具 。 


2.7 Kc TELLE HEU A: ob RES 


自动 化 测试 在 大 部 分 企业 的 推行 过 程 中 都 会 遇 到 各 种 困难 ,在 不 合适 的 项 目 和 不 适当 
的 项 目 阶段 实施 自动 化 ,导致 自动 化 测试 实施 效果 不 佳 ,自动 化 测试 团队 会 被 质疑 其 存在 的 
价值 。 自 动 化 测试 的 实施 是 一 个 复杂 的 过 程 , 须 结合 企业 文化 ,研发 流程 .团队 技术 能 力 \ 项 
目 情况 以 及 实施 成 本 等 多 种 因素 来 逐步 实施 。 以 下 列 出 了 一 些 企 业 在 自动 化 实施 过 程 中 的 
10 个 最 佳 实践 , 供 广大 自动 化 测试 的 爱好 者 参考 。 

CD 在 自动 化 测试 实施 前 ,建立 可 衡量 和 易 达到 的 自动 化 测试 实施 目标 ,不 要 在 初期 制 
定 过 高 的 目标 和 期 望 。 

俗话 说 “好 的 开始 是 成 功 的 一 半 ”, 为 了 后 续 更 好 地 推广 和 实施 自动 化 测试 , 须 在 初期 就 


让 研发 
使 用 














Do 


团队 和 相关 参与 者 看 到 自动 化 测试 带 来 的 好 处 ,增强 大 家 成 功 实施 自动 化 测试 的 信 
可 衡量 的 目标 ,有 助 于 参与 各 方 有 效 地 评估 自动 化 测试 的 效果 ; 易 达 到 的 目标 会 


进一步 鼓励 自动 化 测试 实施 者 按部就班 地 开展 实施 工作 ,避免 采用 急功近利 和 好 高 芍 远 的 


实施 方法 。 


(2) 选择 适合 公司 普遍 使 用 的 测试 工具 ,可 以 是 一 个 工具 或 者 一 组 工具 ,做 出 选择 后 需 
要 针对 选 定 工具 进行 深入 研究 。 
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每 种 测试 工具 都 具有 其 独特 的 优点 和 缺点 ,每 种 工具 都 具有 某 些 独特 适用 的 使 用 场景 ， 
建议 对 工具 充分 了 解 后 再 进行 团队 内 部 的 使 用 技巧 培训 ,夯实 自动 化 测试 实施 的 技术 基础 。 
另外 ,建议 中 小 公司 尽 可 能 选择 使 用 开源 的 测试 工具 ,降低 购买 商业 测试 工具 产生 的 相关 
成 本 。 

(3) 分 析 测 试 项 目的 特点 ,编写 适合 项 目 特点 的 自动 化 测试 框架 ,减少 编写 测试 脚本 的 
重复 性 和 复杂 人 性 ,降低 其 他 测试 人 员 编写 自动 化 测试 脚本 的 门槛 。 

每 个 测试 项 目 都 是 独特 的 ,总 是 会 有 一 些 很 独特 的 测试 需求 ,需要 仔细 分 析 其 特点 后 ， 
由 测试 开发 团队 实现 适合 当前 项 目 使 用 的 自动 化 测试 框架 。 一 个 优秀 的 定制 化 测试 框架 可 
以 有 效 地 推动 自动 化 测试 在 项 目 中 的 实施 。 由 于 大 部 分 测试 人 员 的 编程 能 力 存 在 一 定局 限 
性 , 须 依靠 优秀 的 测试 框架 来 降低 编写 自动 化 脚本 的 难度 ,从 而 让 尽 可 能 多 的 测试 人 员 从 自 
动 化 测试 中 受益 ,更 好 地 调动 团队 积极 性 去 支持 自动 化 测试 的 进一步 实施 。 

(4) 聘用 具备 丰富 开发 经 验 的 工程 师承 担 测试 框架 的 开发 工作 ,并 根据 测试 框架 的 推 
广 程度 进行 不 断 优化 。 

测试 框架 的 意义 已 无 须 袭 述 , 为 了 更 好 地 服务 于 测试 人 员 ,团队 应 该 聘用 最 优秀 的 技术 
开发 人 员 来 承担 测试 框架 的 开发 工作 ,良好 设计 的 测试 框架 会 极 大 地 增加 自动 化 测试 实施 
的 成 功率 。 优 秀 的 测试 框架 也 不 会 短 周 期 内 被 迅速 开发 出 来 ,必须 经 过 一 个 长 期 的 优化 过 
程 ,才能 打磨 出 一 套 适 应 公司 大 多 数 项 目的 自动 化 测试 框架 ,因此 建议 长 期 投入 优化 测试 框 
架 的 人 力 。 

C5) 在 自动 化 测试 工作 开始 大 规模 推广 实施 前 , 须 在 中 小 类 型 项 目 进 行 充 分 试点 实施 ， 
充分 评估 实施 自动 化 测试 的 风险 和 产 出 ,总结 试点 实施 中 的 问题 和 收益 ,并 在 后 期 推广 过 程 
中 尽 可 能 扬长 避 短 。 

为 了 降低 自动 化 测试 实施 过 程 中 的 风险 ,测试 团队 应 该 提前 进行 风险 分 析 ,做 好 针对 性 
的 风险 应 对 计划 ,并 在 中 小 类 型 项 目 中 进行 试点 实施 ,证 明 测试 团队 已 经 做 好 了 实施 自动 化 
测试 的 充分 准备 。 在 试点 过 程 中 尽 可 能 多 地 发 现 问题 ,并 通过 不 断 地 解决 问题 来 完善 自动 
化 测试 实施 的 方法 和 流程 ,为 后 续 的 大 规模 推广 做 好 充分 准备 。 

(6) 获得 开发 团队 的 协作 支持 ,提高 开发 代码 的 可 测试 性 ,降低 自动 化 测试 实施 的 

由 于 测试 工具 本 身 的 局 限 性 ,测试 人 员 的 编程 能 力 以 及 被 测试 对 象 的 复杂 度 , 很 可 能 需 
要 开发 团队 做 出 一 定 程度 的 配合 才能 实现 较为 复杂 的 自动 化 测试 脚本 。 在 自动 化 测试 实施 
前 ,测试 团队 应 该 和 开发 团队 对 代码 的 可 测试 性 要 求 达成 共识 ,建议 制定 代码 开发 的 可 测试 
性 标准 或 规范 ,并 在 自动 化 测试 实施 过 程 中 不 断 完善 。 

(7) 在 需求 相对 稳定 的 阶段 ,开始 UI 层级 大 规模 自动 化 测试 脚本 的 编写 。 

项 目 启动 阶段 ,项 目 需求 一 般 都 是 不 太 稳定 的 ,UI 层 的 需求 变化 很 大 ,如 果 在 项 目 启动 
阶段 就 开始 编写 大 量 UI 级别 自动 化 测试 脚本 ,一旦 需求 发 生 了 大 范围 的 变更 ,那么 自动 化 
测试 脚本 的 维护 工作 量 也 会 随 之 产生 ,这 不 但 会 降低 自动 化 测试 人 员 的 实施 积极 性 ,也 会 增 
加 自动 化 测试 投入 的 人 工 成 本 。 自 动 化 测试 工程 师 会 质疑 自己 为 什么 每 天 都 要 维护 以 前 可 
以 正常 运行 的 自动 化 测试 脚本 。 为 了 降低 自动 化 脚本 维护 的 成 本 , 须 在 项 目 需求 稳定 阶段 ， 
且 大 部 分 严重 bug 已 经 修改 完毕 的 情况 下 ,再 进行 大 规模 自动 化 测试 脚本 的 编写 ,尽量 降 
低 维护 测试 脚本 的 工作 量 ,使 自动 化 测试 脚本 可 以 使 用 更 长 的 周期 。 
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(8) 在 测试 过 程 中 ,使 用 局 部 自动 化 测试 的 实施 策略 。 

有 的 时 候 大 规模 实施 自动 化 可 能 会 带 来 各 种 实施 的 难度 和 困难 ,维护 大 量 的 自动 化 测 
试 脚本 可 能 也 没有 太 多 人 力 和 时 间 去 完成 ,这 样 可 能 会 导致 测试 团队 抵制 使 用 自动 化 测试 
技术 。 测 试 人 员 可 以 尝试 使 用 局 部 自动 化 测试 的 实施 策略 ,找到 相对 重复 的 手工 劳动 过 程 ， 
然后 编写 自动 化 测试 脚本 来 替代 重复 性 的 手工 劳动 。 少 量 的 测试 脚本 编写 和 调试 会 比较 容 
易 , 耗 时 更 少 ,并 且 更 易于 传递 给 其 他 测试 人 员 使 用 。 如 果 能 够 减少 一 些 测试 人 员 的 手工 测 
试 工作 量 , 测 试 团队 何尝 不 多 做 一 些 这 样 的 尝试 呢 ? 小 脚本 积累 多 了 也 是 一 笔 很 可 观 的 财 
富 , 总 会 有 爆发 的 那 一 天 。 

(9) 全 面 提高 自动 化 测试 实施 人 员 的 技术 素质 。 

实施 自动 化 测试 的 技术 要 求 很 高 ,为 了 能 够 保证 自动 化 测试 的 创新 和 普遍 使 用 ,测试 团 
队 负责 人 须 尽 可 能 提高 自动 化 测试 实施 人 员 的 技术 素质 。 每 个 人 的 技术 基础 打 好 了 ,后 续 
才能 发 挥 每 个 人 的 主观 能 动 性 ,结合 项 目 应 用 场景 ,因地制宜 地 编写 出 优秀 的 自动 化 测试 框 
架 和 高 质量 的 测试 脚本 。 我 们 要 认识 到 企业 中 的 “人 "” 才 是 最 重要 的 资产 , 须 让 这 些 重要 的 
资产 不 断 增值 ,而 不 是 让 他 们 贬值 。 

(10) 定期 做 好 自动 化 测试 最 佳 实践 的 总 结 。 

自动 化 测试 的 实施 过 程 不 能 一 跤 而 就 ,也 不 可 能 一 帆 风 顺 ,总 是 会 遇 到 各 种 困难 和 问 
题 ,作为 自动 化 测试 的 实施 团队 应 该 定期 总 结 一 段 时间 内 自动 化 测试 的 得 失 ,不 断 形成 团队 
最 佳 实践 的 自动 化 测试 知识 库 ,这 样 才 能 让 自动 化 测试 技术 在 企业 的 实施 更 加 深入 和 全 面 ， 
确保 企业 在 人 员 流 失 的 时 候 不 至 于 丢掉 宝贵 的 最 佳 实践 经 验 。 建 议 最 佳 实践 经 验 的 资料 都 
放 到 团队 内 部 的 培训 文档 中 ,让 更 多 的 后 来 者 能 够 站 在 前 人 的 肩膀 上 不 断 成 长 ,为 企业 降低 
更 多 的 自动 化 测试 实施 成 本 ,提高 人 员 的 劳动 生产 率 。 














2.8 BESEITIGT: SE RAE ER 





自动 化 测试 相对 于 手工 测试 人 员 来 说 需要 更 多 的 知识 和 编程 技能 ,基于 Python 编程 
语言 , 列 出 一 些 在 使 用 Selenium WebDriver 工具 时 常 遇 到 的 一 些 知识 领域 : HTML,XML, 
CSS, JavaScript, Ajax, MySQL 数据 库 .unittest\Jenkins/Hudson Lettuce 测试 框架 。 

建议 Selenium WebDriver 的 工具 使 用 者 都 尽 可 能 地 深入 学 习 以 上 知识 领域 ,尤其 要 增 
加 学 习 编 程 技能 的 时 间 , 编 程 能 力 的 高 低 直 接 决 定 你 是 否 可 以 写 出 优秀 的 自动 化 测试 框架 。 
真正 的 自动 化 测试 高 手 , 从 技术 能 力 上 来 说 比 中 等 开发 人 员 的 水 平 还 要 高 ,所 以 想 成 为 一 个 
能 够 独当一面 的 自动 化 测试 工程 师 , 须 不 断 地 进行 学 习 各 类 开发 知识 。 不 是 每 个 测试 工程 
师 都 可 以 成 为 自动 化 测试 工程 师 的 ,要 想 改 变 常年 手工 测试 的 命运 ,必须 坚持 不 懈 地 学 习 和 
实践 ,才能 让 我 们 离 自 动 化 测试 的 识 峰 越 来 越 近 , 最 终 有 一 天 我 们 会 站 在 顶峰 摇 旗 呐喊 。 


s (3s 自动 化 测试 辅助 工具 


Selenium 工具 本 身 虽 然 很 强大 ,但 是 它 也 需要 一 些 辅助 工具 来 解决 一 些 特定 的 问题 。 
本 章 主 要 介绍 和 Selenium 工具 配合 使 用 的 辅助 工具 。 


3.1 本 -i 


Firefox 浏览 器 的 安装 步骤 如 下 。 
CD 浏览 器 访问 网 址 http://www. Firefox. com. cn/ 。 
(2) 单 击 浏览 器 页 面 中 的 “免费 下 载 ”, 下 载 Firefox 浏览 器 安装 文件 ,下 载 链接 如 图 3-1 
所 示 。 
(3) 下 载 完 成 后 ,在 下 载 文 件 保 存 目录 会 生成 一 个 文 
Firefox 件 名 为 Firefox-latest. exe 的 文件 。 
(4) 双击 Firefox-latest. exe 安装 文件 ,按照 安装 向 导 
- 步 一 步 地 进行 安装 ,如 无 特殊 安装 路 径 要 求 , 则 不 断 单 
击 “ 下 一 步 ” 按 钮 即 可 完成 Firefox 浏览 器 的 安装 。 
(5) 安装 完毕 后 ,桌面 会 显示 Firefox 浏览 器 的 快捷 方式 图 标 fb Mozilla Firefox | 
更 多 说 明 : 
> 本 书 实例 所 使 用 的 Firefox 浏览 器 版 本 是 49. 0. 1。 
> Firefox 历史 版 本 下 载 请 访问 http://ftp. mozilla. org/pub/firefox/releases/ 。 


3.2 -El i 


Firebug 插件 安装 步骤 如 下 。 
(1) 双击 Firefox 浏览 器 的 快捷 图 标 ,启动 Firefox 浏览 器 。 
(2) 单 击 浏览 器 地 址 栏 区 域 最 右 侧 的 “打开 菜单 "按钮 ,如 图 3-2 所 示 。 


- 4- 9 & 0- £1 E) 


E 32 


C30 在 弹出 的 弹 层 中 , 单 击 弹 层 界面 中 的 “附加 组 件 ”, 如 图 3-3 所 示 。 

(4) 单 击 后 ,Firefox 浏览 器 显示 出 “附加 组 件 页 面 ", 如 图 3-4 所 示 。 

(5) 在 页 面 最 右 侧 的 组 件 搜索 框 中 输入 “Firebug”, 并 单 击 放大 镜 图 案 的 搜索 按钮 ,如 
图 3-5 所 示 。 
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(6) f£ Firefox 浏览 器 显示 出 Firebug 插件 的 相关 信息 后 , 单 击 如 图 3-6 中 右 侧 的 “ 安 
装 "按钮 ,Firefox 会 自动 下 载 和 安装 Firebug 插件 ,等 待 几 分 钟 , 待 下 载 进 度 条 走 完 表 示 下 
载 完成 。 

CD 下 载 后 ,Firebug 插件 会 自动 完成 安装 。 安 装 完 成 后 ,在 插件 管理 页 面 会 显示 出 * 禁 
用 ”和 *“ 移 除 ” 两 个 按钮 ,如 图 3-7 所 示 。 


SSSSSSSSSSSSSSSN 


e 
e Selenium WebDriver 3.0 一 | 自动 化 测试 框架 实战 指南 
e 





Firebug 
> 
e Firebug 为 你 的 Firefox 焦 成 了 浏览 网 页 的 同时 请 手 可 得 的 丰富 开发 工具 ， 你 可 以 对 任何 网 页 的 CSS、HTML 和 JavaScript iB£7XCRISIB— E 更 多 
图 3-6 
b 
Ie zz marl aro 


Web Development Evolved. Firebug is free and open source software distributed under the BSD License =S 
E 3-7 


至 此 ,Firebug 插件 全 部 安装 完成 。 


3.3 isl oV Eris: EE: 


本 节 主 要 介绍 Firebug 插件 的 使 用 方法 和 常用 功能 。 
3.3.1 启动 Firebug 插件 


启动 Firebug 的 步骤 如 下 。 

CD 启动 Firefox 浏览 器 。 

(2) 方法 1: 在 Firefox 浏览 器 工具 栏 的 最 右 侧 区 域 单 击 Firebug 插件 快捷 图 标 进行 启 
动 ,如 图 3-8 所 示 。 


4-9 4 D-——--)z- 


图 3-8 





方法 2: 启动 Firefox 浏览 器 后 ,直接 按 F12 快捷 键 ,启动 Firebug 插件 。 
(3) Firebug 插件 启动 完成 后 ,在 Firefox 浏览 器 下 方 区 域 会 出 现 Firebug 插件 的 操作 
界面 ,如 图 3-9 所 示 。 


e UA < » 0 mune HTML Css Wt DOM MiS Cookies 


Po 控制 台 面板 已 被 禁用 
使 用 Firebug 的 工具 栏 图 标 来 同时 启用 或 茜 用 所 有 面板 。 单 狐 控 制 甘 一 面板 ， 请 使 用 相应 标签 的 茶 单 。 Conso) 
启用 
图 3-9 


3.3.2 Firebug 插件 的 常用 功能 


1. Firebug 插件 的 配置 菜单 

启动 Firebug 插件 后 , 单 击 如 图 3-10 所 示 的 Firebug 图 标 后 ,会 弹出 Firebug 插件 的 配 
置 菜单 。 通 过 改变 配置 菜单 项 设置 可 以 对 Firebug 插件 做 自 定义 设置 ,如 停 用 Firebug、 隐 
藏 Firebug 改变 Firebug 的 界面 位 置 等 。 
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可 见面 板 > 
自 定义 快捷 键 Ctrl+Shift*Alt+B 
关于 - 20.18 





图 3-10 


2. Firebug 插件 的 查看 功能 使 用 实例 

Firebug 插件 功能 的 使 用 方法 如 下 。 

(1) 使 用 Firefox 浏览 器 打开 http://sogou. com 网 页 。 

(2) fi F12 键 ,启动 Firebug 插件 。 

G) ARAA” fpem, 

(4) 在 搜狗 首页 的 链接 ,按钮 或 者 输入 框 上 方 悬浮 鼠标 ,在 Firebug 中 会 显示 与 页 面 元 
素 对 应 的 HTML 代码 ,如 图 3-11 所 示 。 


(GS) 搜狗 搜索 


[Ur liae d NS 








Q O Noo) Network Sources Timeline Profies Resources Audits Console 












v ntu Jange"cn ge 
> chead»..k/head» Fe 
v «body style 
- elemen 
) 
„seare 
input, 
input 
[d.e -| 
mame-"sf^ ide"sf* onsubmite"if(this.query.valueee'*), false; heii 
- si esso mia Date( ) .getTine( )/1000);"» / n 
Cumt Up tat cane cine mamee"query" id«"query" maxlengthe"108" mitocomplete- Uns. = 
E e - 2 
图 3-11 
通过 此 方法 ,用 户 可 以 轻松 地 找到 页 面 元 素 对 应 的 HTML 代码 ,这 对 于 精确 定位 页 面 


元 素 是 非常 有 帮助 的 。 

3. HTML 面板 的 使 用 实例 

CD 使 用 Firefox 打开 http://www. sogou. com 首页 。 

(2) 按 F12 键 ,启动 Firebug 插件 。 

(3) Mih Firebug 中 的 HTML 标签 栏 mL 

(4) Firebug 会 在 HTML 的 标签 栏 下 方 显示 sogou 首页 的 HTML 代码 ,如 图 3-12 
所 示 。 
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(5) 使 用 鼠标 在 HTML 代码 区 域 进行 悬浮 ,可 以 看 到 sogou 首页 的 页 面 元 素 会 被 高 亮 
突显 出 来 ,通过 此 方法 可 以 获知 HTML 代码 在 页 面 上 对 应 的 元 素 及 其 位 置 。 
例如 ,鼠标 悬浮 在 HTML 代码 行 


input autocomplete = "off" maxlength = "100" size = "47" onfocus = "this. select()" class = "q" 
id = "query" name = "query" 


上 方 , 在 搜狗 首页 中 可 以 看 到 搜索 框 被 高 亮 突 出 显示 ,如 图 3-13 所 示 。 


(GS) 搜 狗 搜索 
mn 


图 3-13 


4. 其 他 标签 栏 的 作用 概述 

> CSS tab: 此 tab 会 显示 页 面 的 CSS 样式 表 代码 。 

> 脚本 tab: 此 tab 会 显示 页 面 的 JavaScript 代码 。 

> Dom tab; 此 tab 会 显示 页 面 的 Dom 属性 。 

> 网 络 tab: 此 tab 会 显示 页 面 产 生 网 络 请 求 所 发 生 的 耗 时 。 

» Cookies tab; 此 tab 会 显示 页 面 产生 的 cookie 信息 。 

由 于 篇 幅 所 限 ,以 上 功能 不 能 全 部 做 详细 说 明 ,请 读者 自行 了 解 更 加 详细 的 使 用 技巧 。 


^ EE 


安装 FirePath 插件 的 操作 步 又 如 下 。 

CD 请 参阅 本 章 中 的 说 明 步 又 ,分 别 安装 好 Firefox 浏览 器 和 Firebug 插件 。 
(2) 双击 Firefox 浏览 器 的 快捷 图 标 ,启动 Firefox 浏览 器 。 

(3) 单 击 浏览 器 地 址 栏 区 域 的 最 右 侧 “打开 菜单 ”按钮 ,如 图 3-14 所 示 。 
(4) 在 弹 层 中 , 单 击 弹 层 界面 中 的 “附加 组 件 ”, 如 图 3-15 所 示 。 

(5) Firefox 浏览 器 显示 出 “附加 组 件 ” 页 面 ,如 图 3-16 所 示 。 
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图 3-14 
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图 3-16 
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(7) 页 面 显示 信息 如 图 3-18 所 示 。 


E uh 
Sio. 
ES FirePath Sha n 
FirePath is a Firebug extension that adds a development tool to edit, inspect and generate XPath 1.0 expressions, CSS3seletona. ES 


ex 


图 318 
(8) 单 击 “ 安 装 ” 按 钮 ,开始 下 载 FirePath 插件 ,如 图 3-19 所 示 。 


5) 


(9) 下载 完 成 后 , Firefox 浏览 器 会 自动 进行 安装 , 单 击 * 立 即 重 启 链 接 后 ,完成 
FirePath 插件 的 所 有 安装 步骤 ,如 图 3-20 所 示 。 


wf FirePath 将 在 Firefox EMEDIA. 立即 重启 mus 
Em FirePath 单 击 重启 浏览 器 
ME rircPath is a Firebug extension that adds a development tool to edit, inspect and generate XP: 


图 3-20 


3.5 Miliiz- usd d:55Es: 


本 节 将 详细 介绍 FirePath 插件 的 使 用 方法 和 使 用 技巧 ,使 读者 掌握 使 用 FirePath 插件 
获取 页 面 元 素 XPath 表达 式 的 方法 。 
3.5.1 FirePath 插件 中 使 用 XPath 定位 方式 

1. 使 用 手写 XPath 方式 查找 页 面 元 素 

CD 启动 Firefox 浏览 器 ,访问 http://www. sogou. com 网 页 。 


(2) 按 F12 快捷 键 启动 Firebug 插件 , 单 击 FirePath 标签 栏 显 示 FirePath 的 使 用 界面 ， 
如 图 3-21 所 示 。 





* Y< 》 X5 paa HTML css Gk DOM MiS Cookies FirePath~ 
TopWindow + Highlight | XPath: ~ 
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G) 在 图 3-21 中 的 输入 框 中 输入 XPath 4g f 3A X" / /input[ (9 id — "query"]”, 查 找 
页 面 中 id 属性 值 为 "query” 的 输入 框 。 按 Enter 键 后 ,在 FirePath 插件 的 代码 显示 区 域 会 
显示 被 找到 的 页 面 元 素 的 HTML 代码 ,如 图 3-22 所 示 。 鼠 标 悬 浮 在 被 找到 的 HTML 代码 
上 ,在 网 页 显示 区 域 中 ,搜索 输入 框 将 高 亮 突 出 显示 ,如 图 3-23 所 示 。 








* WW < 》 X5 ea Wm css WE DOM Fes Cookies| FirePath v 
| Top Window - Highlight | XPath: -  //inputiGid-"query'] 


(input id-"userr" class-'a" autocomplete-"ofí" maxlength-"100" sizes 4i" omfocus this select" mamez seri /) — 

















' (SG) 搜狗 搜索 


图 3-23 


使 用 FirePath 插件 ,可 以 方便 地 练习 XPath 语法 ,验证 编写 的 XPath 表达 式 是 否 正 确 ， 
找到 期 望 的 页 面 元 素 及 其 对 应 的 HTML 代码 。 

在 后 续 自 动 化 测试 编程 过 程 中 ,测试 工程 师 会 经 常 使 用 此 插件 来 验证 XPath 表达 式 的 
正确 性 。 

2. 使 用 FirePath 插件 获取 页 面 元 素 的 XPath 表达 式 

CD 启动 Firefox 浏览 器 ,访问 http://www. sogou. com 网 页 。 

(2) fig F12 快捷 键 启动 Firebug 插件 。 

(3) 在 搜狗 首页 的 搜索 输入 框 上 方 单 击 鼠 标 右键 ,在 弹出 菜单 中 单 击 “ 使 用 Firebug 查 
看 元 素 " 命 令 , 如 图 3-24 所 示 。 














(4) 单 击 后 ,在 Firebug 插件 的 HTML 区 域 高 亮 显 示 出 搜索 输入 框 对 应 的 HTML 代 
码 , 如 图 3-25 Bron 。 








o 
e -— Selenium WebDriver 3.0.— Bah cR CE de Sc i 
> | 


* UP € 》 X3 pua HM- css Wt DOM W'S Cookies Firepath 
i | 48 | inputrqueryq < divaborder < formzsf < divelogin..ogo-wrap < bodyssgbg < html 
sr te 
S «form 1d="sf" onsubmit-"4ocument sf. ast value-Math round(new Date() estTies0 /2000);" name="s#" action="/wsb"> 
国 cdiv id 
国 <span class="adv"> 
lil «div class="aborder"y 








caim 
<input id="std" elass="stb" type="submit" ommouseost="this clasiame-' stb " ommouseus="this clasiiame-'stb'" onmousedom 
input type="hidden" valus-"www sogou com" name" aci" 


3-25 


G) 在 高 亮 显示 的 HTML 语句 上 方 , 单 击 鼠 标 右键 后 弹出 菜单 ,选择 “在 FirePath ifii 
板 中 查看 ”, 然后 再 在 高 亮 显示 的 HTML 代码 上 单 击 右键 ,在 弹出 的 菜单 中 选择 
CopyXPath 菜单 项 可 获取 搜索 框 的 相对 路 径 的 XPath 定位 表达 式 , 也 是 最 简单 的 XPath 定 
位 路 径 , 如 图 3-26 所 示 。 

<span class="sec-input-box"> 


» Copy XPath 
<span clé Copy CSS Selector 
Set as XPath 












-复制 页 面 元 素 的 XPath 相对 路 径 定 位 表达 式 


" type-"hidden"/» 





图 3-26 


(6) 打开 一 个 写字 板 文件 ,可 以 粘贴 后 来 查看 复制 的 XPath 定位 表达 式 , 如 图 3-27 
所 示 。 


B xpath.te - 记事 本 
FHF) SAINE) 格式 (O) 查看 (V) 帮助 (H) 
xpath 相 对 路 径 定位 表达 式 : . //*[@id=" query' ] 


图 3-27 


使 用 此 方法 ,可 以 自动 获取 到 页 面 元 素 的 XPath 定位 表达 式 ,但 使 用 这 种 方法 获取 到 
的 页 面 元 素 的 XPath 定位 表达 式 ,在 测试 脚本 执行 过 程 中 不 一 定 能 通过 ,所 以 最 好 的 方法 
是 手动 编写 XPath 定位 表达 式 ,并 用 于 自动 化 测试 代码 中 的 页 面 元 素 定 位 语句 中 。 


3.5.2 FirePath 插件 中 使 用 CSS 定位 方式 


1. 使 用 手写 CSS 方式 查找 页 面 元 素 

具体 操作 步骤 如 下 。 

CD 启动 Firefox 浏览 器 ,访问 http://www. sogou. com 首页 。 

(2) f F12 快捷 键 启动 FirePath 插件 , 单 击 FirePath 标签 栏 显 示 FirePath 插件 界面 ， 
如 图 3-28 所 示 。 

G) 单 击 XPath 旁边 的 下 拉 小 箭头 ,选择 CSS 菜单 项 ,如 图 3-29 所 示 。 
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* Ẹ € » X5 ea HM css Wè DOM M Cookies] FirePath -| 
Top Window + Highlight | XPath: ~ 

















图 3-28 


Top Window = Highlight Xpath:( die 


图 3-29 


CD 在 图 3-30 的 输入 框 中 ,输入 “# query" CSS 定位 表达 式 来 查找 页 面 中 id 属性 为 
“query” 的 输入 框 。 按 Enter 键 后 ,在 FirePath 插件 的 代码 显示 区 域 中 会 显示 被 查找 到 页 面 
元 素 对 应 的 HTML 代码 ,如 图 3-30 所 示 。 和 鼠标 甚 浮 在 被 找到 的 HTML 代码 上 ,在 网 页 显 
示 区 域 上 搜索 输入 框 将 高 亮 显 示 , 如 图 3-31 所 示 。 





* U € >>= pya HTML CSS Wd DOM 网 络 Cookies( FirePath =) 
| Top Window - [Highlight , css: 09 - ( #auey v Css 定位 表达 式 


3 div Content" classe"content"? 
div ide"top-float-bar" class-"pos-header"» 
@ «div ide"logo-s" class-"logo2"» 


选择 CSS 定 位 方式 国 div id-"logo-l” class-"logo" 
选择 CSS 定 位 方式 回 ediy id soarch-bor” classe search-box" 
回 «form ide"sf" action-"/web" nmame-"sf" onsubmit-"if (this. query. value=" ")return false:d. 
@ <span  class""sec-input-box"? 











/span? 
@ <span  class-"enter-input"» 


图 3-30 


合 ) 搜 狗 搜 索 


图 3-31 
使 用 此 方法 ,可 以 通过 手写 CSS 定位 表达 式 来 查找 页 面 元 素 以 及 对 应 的 HTML 代码 ， 
也 可 以 验证 CSS 定位 语句 的 正确 性 , 即 是 否 可 以 找到 期 望 的 页 面 元 素 。 
2. 使 用 FirePath 插件 获取 页 面 元 素 的 CSS 定位 路 径 


具体 操作 步骤 如 下 。 
CD 启动 Firefox 浏览 器 ,访问 http://www. sogou. com 网 页 。 


E 








B 
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(2) f F12 快捷 键 启 动 FirePath 插件 。 

CD 在 首页 搜索 输入 框 上 方 , 单 击 鼠 标 右键 ,在 弹出 命令 菜单 中 , 单 击 “ 使 用 FirePath 查 
ALR’ ME. 

(4) 在 FirePath 插件 的 HTML 区 域 高 亮 突 出 显示 搜索 输入 框 的 对 应 HTML 代码 ,如 
图 3-32 所 示 。 


* F < ) XS pa HM- css Wẹ DOM WIS Cookies FirePsth 





getTimo() /1000) ;" namez”st” action=" /web"> 
LET ^ 
@ <span class=”adv"> 








(5) 在 高 亮 突出 显示 的 HTML 语句 上 , 单 击 鼠标 右键 ,在 弹出 的 菜单 中 ,选择 “在 
FirePath 面板 中 查看 ”, 然 后 再 在 高 亮 显 示 的 HTML 代码 上 单 击 右键 ,选择 CopyCSS 
Selector 命令 获取 搜索 输入 框 的 CSS 定位 表达 式 , 如 图 3-33 所 示 o 


m 1G" st action= /wep name= st  onsupmit- 1T\tnis. query. Value 一 Jreturn raise:aoc 
«span  class-"sec-input-box^ 











7 Copy XPath rp AR "PUES 
— 复制 页 面 元 素 的 CSS 定 位 表达 式 








«span cl Copy CSS Selector: 

<input r Set as XPath m” type="hidden”, 

input r 

dapib i 滚动 到 此 处 

input r 在 命令 行 中 使 用 

<input r 在 HTML 面板 中 查看 hidden”/> 

input r 在 DOM 面板 中 查看 in" type-"hidden"/» 
图 333 


(6) 打开 一 个 写字 板 文件 ,粘贴 复制 的 CSS 定位 表达 式 , 如 图 3-34 所 示 。 


| M essvt - 记事 本 
| 文件 (F) 编辑 (E) 格式 (O) 查看 (V) 帮助 (H) 
query 

图 3-34 


使 用 此 方法 ,可 以 自动 获取 页 面 元 素 的 CSS 定位 表达 式 , 并 在 自动 化 测试 脚本 的 定位 
语句 中 使 用 。 





3.6 HEPA EAE EU a 





在 IE 8 以 上 版 本 中 , 均 自 带 辅助 开发 工具 ,功能 也 类 似 于 Firefox 浏览 器 中 的 Firebug 
插件 ,可 用 于 查看 页 面 元 素 。 但 是 IE 的 辅助 开发 工具 不 支持 XPath 表达 式 定位 ,所 以 无 法 
使 用 它 来 获取 页 面 元 素 的 XPath 定位 表达 式 。 


=% 
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启动 TE 浏览 器 后 , 按 F12 快捷 键 即 可 打开 TE 浏览 器 的 辅助 开发 工具 ,如 图 3-35 所 示 。 


DOM 资源 管理 器 Poo 





图 3-35 
在 自动 化 测试 脚本 开发 过 程 中 ,此 辅助 开发 工具 主要 用 于 查看 页 面 元 素 的 HTML 代 


码 , 在 Firefox 浏览 器 不 能 正常 显示 页 面 元 素 时 ,可 以 结合 此 工具 来 查看 页 面 元 素 的 HTML. 
代码 ,以 便 后 续 编写 页 面 元 素 的 XPath 或 者 CSS 定位 表达 式 。 


N 


一 般 情 况 下 ,初级 自动 化 测试 工程 师 都 是 从 使 用 Selenium IDE 插件 开始 自己 的 自动 化 
测试 生涯 的 。 此 工具 的 特点 是 用 图 形 界 面 进行 操作 ,容易 上 手 使 用 ,不 但 支持 录制 操作 ,还 支 
持 导出 其 他 编程 语言 的 自动 化 脚本 。 但 是 此 工具 不 太 适 合 在 复杂 的 自动 化 项 目 中 使 用 , 它 仅 
能 支持 Firefox 浏览 器 。 对 于 使 用 纯 编 程 方式 编写 自动 化 测试 脚本 的 读者 ,可 以 跳 过 此 章节 。 


4.1 EACAN 


Selenium IDE 是 一 种 Firefox 浏览 器 插件 , 仅 限于 Firefox 浏览 器 中 ,可 实现 网 页 操作 
步骤 的 录制 和 回放 ,使 用 此 插件 可 执行 简单 测试 逻辑 的 自动 化 测试 ,可 将 Selenium IDE 插 
件 的 脚本 导出 为 Java、Python、C# 等 多 种 语言 格式 的 程序 代码 ,可 将 人 为 操作 网 页 的 各 种 
动作 直接 转化 为 自动 化 测试 的 程序 代码 ,便于 编写 更 加 复杂 的 测试 代码 。 

此 插件 的 优点 是 小 巧 简单 ,无 编程 经 验 也 能 够 快速 上 手 使 用 ,可 使 用 列表 方式 选择 操作 
命令 ; 缺点 是 录制 脚本 转换 为 其 他 语言 脚本 时 有 可 能 出 现 一 些 错误 ,还 需要 自动 化 测试 工 
程 师 人 为 修改 。 学 习 此 插件 需要 熟悉 HTML, JavaScript 和 DOM 相关 的 知识 。 

基于 测试 行业 内 的 最 佳 实践 经 验 ,Selenium IDE 工具 仅 适合 用 于 执行 简单 迎 辑 的 自动 
化 测试 脚本 ,或 通过 录制 方式 导出 相关 语言 的 自动 化 测试 脚本 ,不适 于 执行 大 中 型 项 目的 自 
动 化 测试 程序 ,因此 本 章 仅 介绍 此 插件 的 常用 功能 。 


Selenium IDE 


4.2 时 -EU 


本 节 主 要 介绍 Selenium IDE 的 安装 .使 用 方法 以 及 使 用 技巧 。 
4.2.1 从 Selenium 官网 安装 


具体 操作 步骤 如 下 。 

CD 打开 Firefox 浏览 器 ,访问 网 址 http://www. seleniumhq. org/download/ 。 

(2) 打开 页 面 后 ,可 以 看 到 Selenium IDE 插件 的 下 载 链 接 , 如 图 4-1 所 示 。 

(3) 单 击 from addons. mozilla. org 的 链接 ,Firefox 浏览 器 将 跳 转 到 如 图 4-2 所 示 的 
页 面 。 

(4) 单 击 Add to Firefox 按钮 后 ,将 会 在 浏览 器 的 左上 角 弹 出 如 图 4-3 所 示 的 窗口 , 单 
击 “ 安 装 ” 按 钮 开始 下 载 并 安装 Selenium IDE 插件 。 

(5) 安装 完成 后 ,重启 Firefox 浏览 器 ,Selenium IDE 插件 安装 成 功 , 在 Firefox 浏览 器 
的 “工具 ”菜单 下 会 显示 Selenium IDE 插件 的 菜单 项 ,如 图 4-4 所 示 。 
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Selenium IDE 


Selenium IDE is a Firefox plugin which records and plays back user interactions with the browser. Use 
this to either create simple scripts or assist in exploratory testing. It can also export Remote Control or 
WebbDriver scripts, though they tend to be somewhat brittle and should be overhauled into some sort of 
Page Object-y structure for any kind of resiliency..- i 单 击 获取 最 新 版 本 下 载 地 址 


Download latest released version from addons.mozilla.o; rg or view the Release Notes and then install 
some plugins. a i 


Download previous versions here. e. — rue A FREE 


图 4-1 


Mi LLL. A ALAL. LhA.,àAIGI 


€ O & Mozilla Foundation (US) https://addons.mozilla.org/en-US/firefox/addon/selenium-ide/ UN c Cm. 


}Add-ons 


EXTENSIONS THEMES COLLECTIONS MORE 


or Selenium IDE d 
JU 


ium | rat ç t elenium tests. It i 
mplem 3 r ws you to re and debug 


APEEF 


rr ou 





图 42 


| C snnerdon- x E 


€ (dr à Mozilla Foundation (US) https;//addons.mozilla.org/en-US/firet 





addons.mozilla.org x 
此 网 站 想 让 您 在 Firefox 中 安装 一 个 附加 组 件 : 


Selenium IDE 
详细 了 解 … 


单 击 安装 Selenium IDE 插 件 


WO | 4380 











下 载 (D) Ctrl) 
附加 组 件 (A) — Ctrl+Shift+A 
e ASW 

Web 开发 者 > 


piati 
选项 (Q) 


HttpRequester Ctrl+Alt+P 
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(6) 单 击 Selenium IDE 插件 的 菜单 项 ,在 Firefox 浏览 器 中 弹出 Selenium IDE 插件 的 
操作 界面 ,如 图 4-5 所 示 。 



























































4.2.2 使 用 离线 XPI 安装 文件 安装 


由 于 Selenium 官网 的 服务 器 在 美国 ,中 国 和 美国 的 网 络 经 常会 出 现 不 稳定 情况 ,如 果 
网 络 连接 失败 也 就 无 法 实现 从 官网 进行 安装 。 作 为 可 选 的 安装 方式 ,用 户 可 从 搜索 引擎 网 
站 下 载 Selenium IDE 插件 的 KPI 安装 文件 来 完成 插件 安装 。 

(1) 打开 Firefox 浏览 器 。 

(2) 将 Selenium IDE 的 安装 文件 (扩展 名 为 . xpi) 拖 搜 到 Firefox 浏览 器 中 ,弹出 图 4-6 
所 示 的 框 体 。 

G) 单 击 “立刻 安装 ?按钮 ,后续 的 安装 步骤 和 从 官网 安装 Selenium IDE 插件 的 步骤 一 
致 ,此 处 不 再 缆 述 。 
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gers 请 —EREEDEENNENEC -— 
A 要 重 软件 可 能 会 损 喜 起 的 计算 机 或 者 伤害 您 的 隐私 . 
您 已 选择 安装 下 列 5 项 目 : 
Selenium IDE: Ruby Formatters (PERES) 2 
file.///C:/Users/foster wu/Downloads/selenium-ide-2.5.0.xpi 
Selenium IDE (/t£*€5) 


file:///C:/Users/foster wu/Downloads/selenium-ide-2.5.0.xpi 


Selenium IDE: Python Formatters (#5485) 
file///C:/Users/foster wu/Downloads/selenium-ide-2.5.0.xpi 

















4.3 EAC D SE TEE pt bri EA 


Selenium IDE 具有 操作 界面 ,通过 使 用 界面 可 以 让 测试 工程 师 便捷 地 进行 各 种 操作 。 
具体 的 界面 介绍 请 参阅 下 面 的 介绍 。 


4.3.1 EF hi 
Selenium IDE 插件 的 主 界面 如 图 4-7 所 示 。 
























RRD MAR Adis. omae Ua. 
| UR iae eas gone p ORRE 
Gmm a» oo 
Table sowe 
Command- Target m Vátue- 
open / 
itype id-query X2 IBBGPANU 
didkAndWai —— id-stb yar 
AESi EAS f 
WAT 
4 n kam 区 域 
和 一 一 一 
| To . 
Runs 1 Valve. 
Failures 0| 一 = 一 
| tog | Reference | Ur-tlement | Rodup 
[nfo] Playing test cose EIREAG 
[info] Executing: |open | / | | iz 
| Teo] Executing: Itvpe 1 4-quer LR me NERT 执行 日 志 显示 区 域 
(info ] Executing: [cickAndWat | id-stb | | 
[info] Test case passed 
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4.3.2 常用 工具 栏 


Selenium IDE 插件 中 常用 的 工具 栏 如 下 。 
:测试 用 例 执 行 速度 的 控 
LOPE 执行 当前 测试 用 例 按钮 。 
DE: 执行 全 部 测试 用 例 按钮 。 
w, 暂停 按钮 。 

: 单 步 执 行 按钮 。 

: 停止 或 继续 执行 按钮 。 

: 录制 脚本 按钮 。 

: 创建 定时 任务 。 

: 应 用 汇总 功能 : 此 功能 为 高 级 功能 ,可 以 将 多 个 命令 行 合 并 为 一 个 命令 来 执行 。 


4.3.3 ”脚本 编辑 区 域 
Selenium IDE 插件 脚本 编辑 区 域 如 图 4-8 所 示 。 





司 可 司 同 上 a 





Table Source 

Command Target Value 

open / 

pe =kw 光荣 之 器 生动 化 出 区 

dick idzsu 

Command type - 
Target — id-kw ~ | Select Find 





图 4-8 


(1) Command 列 : 显示 操作 命令 名 称 。 

(2) Target 列 : 显示 被 操作 页 面 元 素 的 id name, CSS 或 者 XPath 等 定位 表达 式 。 

G) Value 列 : 数值 列 显示 本 行 操作 要 使 用 的 数值 ,可 以 是 文件 ,数字 ,变量 或 者 表达 式 。 
(4) Command 列 命令 后 面 如 果 只 有 Target 列 .表示 此 操作 命令 无 须 输入 参数 。 


本 节 主 要 介绍 常用 的 Selenium IDE 菜单 项 。 
4.4.1 “文件 "菜单 
Selenium IDE 文件 菜单 列表 如 图 4-9 所 示 。 


各 菜单 项 含义 介绍 如 下 。 
> New Test Case: 新 建 测试 用 例 。 


. 34. 
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> Open: 打开 测试 用 例 ( 或 者 测试 集 ) 。 

> Save Test Case: 保存 测试 用 例 。 

> Save Test Case As; 将 测试 用 例 另存 为 。 

> Export Test Case As: 将 测试 用 例 导出 为 特定 语言 的 测 
试 程序 。 

» Recent Test Case; 最 近 打 开 的 测试 用 例 。 

» Add Test Case: 新 建 测试 用 例 。 

> Properties: 属性 。 

> New Test Suit: 新 建 测试 集合 。 

> Open Test Suit: 打开 测试 集合 。 

> Save Test Suite: 保存 测试 集合 。 

» Save Test Suite As; 将 测试 集合 另存 为 。 

> Export Test Suite As; 导出 测试 集合 为 。 图 43 

> Recent Test Suites; 最 近 打 开 的 测试 集合 。 

> 关闭 : 退出 Selenium IDE 插件 。 


4.4.2 “编辑 ”菜单 
Selenium IDE 插件 的 “编辑 "菜单 列表 如 图 4-10 所 示 。 
主要 菜单 项 含义 如 下 。 
> Insert New Command: 插入 操作 命令 。 
> Insert New Comment: 插入 注释 信息 。 





HE] WWE) Actions Option 
NewTestCase — Cyl+N 
Open. culyO 
Save Test Case Cul+S 
Save Test Case As... 

Export Test Case As — » 
Recent Test Cases » 
Add Test Case.. Ctrl+D 
Properties.. 
New Test Suite 
Open Test Suite.. 
Save Test Suite 
Save Test Suite As... 
Export Test Suite As — » | 
Recent Test Suites 




















4.4.3 Actions 菜单 


Selenium IDE 插件 中 的 Actions 菜单 列表 如 图 4-11 Bros 。 


Record 

Play entire test suite 
Play current test case 
Play test suites periodically 
Toggle Breakpoint 
Set / Clear Start Point 
Pause / Resume 

Step 

Execute this command 
Fastest(0) 

Faster(-) 





Slowest(9) 


e? i i 
自动 化 测试 框架 实战 指南 
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各 项 菜单 含义 如 下 。 

» Record: 录制 。 

» Play entire test suite; 执行 全 部 测试 集合 。 
> Play current test case: 执行 当前 测试 用 例 。 
> Play test suites periodically; 定时 执行 测试 集合 。 
> Toggle Breakpoint: 插入 断 点 /取消 断 点 。 
> Set/Clear Start Point; 设置 和 清除 开始 点 。 
» Pause/Resume: 暂停 /继续 。 

» Step: 单 步 执行 。 

» Execute this command: 执行 当前 行 命令 
> Fastest: 最 快速 执行 测试 用 例 。 

» Faster; 较 快 速度 制定 测试 用 例 。 

> Slower: 较 慢 速度 执行 测试 用 例 。 

> Slowest: 最 慢 速度 执行 测试 用 例 。 







4.4.4 Option 菜单 ERES we 
Eormat > 
Selenium IDE 插件 的 Option 菜单 列表 如 图 4-12 | Clipboard Format : 
示 ` Beset IDE Window 

所 示 。 1 Clear history > 
各 菜单 项 含义 如 下 。 Schedule tests to run periodically 
> Options; 选项 菜单 ,该 菜单 界面 如 图 4-13 和 图 4-14 图 412 

所 示 。 





ie 测试 文件 编码 


Defaut timeout value of recorded command in milliseconds (30s = 30000m) 


Bri. UNO 
Selenium Core extensions Javasrptdf RC 
E> 


m— - 
a epe RCM CHEMALH IHR qui 


dlc voici spy nih otii a 








URL 


自动 断言 浏览 器 标题 
记录 绝对 URL 地 址 
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定位 元 素 方式 的 
先 级别 
































图 4-14 
> Format; 格式 菜单 ,其 级 联 菜单 如 图 4-15 所 示 。 











4-15 


> Clipboard Format; 剪贴 板 内 容 格式 ,其 级 联 菜单 如 图 4-16 所 示 。 





此 菜单 项 用 于 设 定 脚本 区 域 中 显示 的 代码 语言 类 型 ,默认 设 定 HTML 语言 即 可 。 
在 脚本 区 域 单 选 或 者 多 选 脚本 行 , 按 Ctrl 十 C 组 合 键 ,打开 一 个 TXT 文件 , 按 Ctrl 十 V 


AE 


SN 


e 
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组 合 键 , 可 将 IDE 录制 的 脚本 转换 为 Python 语言 格式 的 测试 程序 。 
> Reset IDE Window: 重 置 IDE 窗口 。 
> Clear history; 清除 历史 ,如 图 4-17 所 示 的 三 个 命令 。 


Clear base URL history «jm 清除 base URL 历史 
Clear recent test cases history «gsm JAER GEDRA E 








Clear recent test suites history À—— 浓 除 最 折 测 试 集合 历史 
图 4-17 
4.5 MEXJpIE od p ss 


具体 操作 步 又 如 下 。 
(1) 打开 Firefox 浏览 器 , 单 击 “工具 ”菜单 ,然后 单 击 Selenium IDE 命令 ,打开 


Selenium IDE 界面 。 
(2) 在 Selenium IDE 中 的 Base URL $f A HE P 4$ A " http://www. sogou. com”, 如 


图 4-18 所 示 。 





文件 日 SRE Actions Options Mh 
Base URL httpj//www.sogou.com/ 





图 418 
C3) 单 击 * 录 制 脚本 ”按钮 ,将 录制 脚本 按钮 设置 为 录制 状态 图 (注意 : 按 下 此 按钮 后 ， 
Firefox 浏览 器 中 的 所 有 操作 均 会 自动 录制 为 IDE 脚本 ) 。 
(4) 在 Firefox 浏览 器 地 址 栏 中 输入 *http://www. sogou. com”, 然 后 按 Enter 键 。 
(5) 在 搜索 输入 框 中 输入 “光荣 之 路 自动 化 测试 ”, 单 击 “ 搜 索 ” 按 钮 。 
(6) 页 面 显示 搜索 结果 ,此 时 查看 Selenium IDE 的 脚本 编辑 区 域 ,可 以 看 到 Selenium 
IDE 脚本 被 自动 生成 ,如 图 4-19 所 示 。 


Command Target Value 
open / 
type id=query 光荣 之 路 自动 化 测试 
clickAndWait id=stb 

图 4-19 


CD). 再 次 单 击 Selenium IDE 的 录制 脚本 按钮 ,将 其 转换 为 非 录 制 状态 e 。 

(8) fh E .可 看 到 刚才 手工 操作 的 步骤 被 Firefox 浏览 器 自动 执行 ,并 且 运 行 成 功 。 
左下 方 显 示 绿 色 进 度 条 ,Failures 为 0 表示 脚本 运行 成 功 ,如 图 4-20 所 示 。 

(9) 单 击 文件 菜单 的 Save Test Case, 将 此 用 例 保存 为 "sogou 搜索 测试 . html” 的 文件 ， 
如 图 4-21 所 示 。 

以 上 就 是 最 简单 的 录制 和 回放 的 例子 ,基于 此 实例 的 操作 方法 ,读者 可 自行 录制 更 多 的 
页 面 元 素 操 作 并 进行 回放 ,以 此 方式 来 尝试 执行 基本 的 自动 化 测试 操作 。 
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Log | Reference | Ul-Element | Rollup 


lick (locator) 








Arpaser: 
. 












































4.6 EAC SE p EZ: Selenese 


Selenium IDE 的 Command 命令 也 被 称 为 Selenese。 

> Selenese 命令 最 多 有 两 个 参数 ,一 个 是 target, 一 个 是 value; 

> 根据 命令 类 型 的 不 同 , Selenese 命令 可 以 没有 参数 ,也 可 以 只 有 一 个 参数 或 者 两 个 
参数 。 


,全 
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> Selenese 命令 只 有 一 个 参数 时 ,参数 值 必须 写 在 target 列 中 。 
Selenese 命令 的 三 种 类 型 如 表 4-1 所 示 。 
表 4-1 含义 

命令 类 型 含 po 
此 类 命令 直接 和 页 面 元 素 进行 交互 。 
例如 : 
click 命令 会 在 页 面 中 直接 单 击 页 面 元 素 ; 
type 命令 会 在 页 面 的 文本 框 中 输入 文字 ,输入 的 文字 内 容 会 显示 在 文本 框 中 
此 类 命令 允许 将 值 存 储 到 变量 中 。 
Accessors( 存 储 器 ) 类 型 | 例如 : storeTitle 命令 属于 存储 器 类 型 命令 , 它 只 会 将 页 面 的 title 信息 读 取 
出 来 ,并 存储 到 变量 中 , 它 本 身 不 和 页 面 元 素 产生 任何 交互 动作 
此 类 命令 用 于 验证 某 个 条 件 是 否 真实 发 生 








Actions( 动 作 ) 类 型 








三 种 断言 命令 : 
> Assert; "4 assert 命令 执行 失败 ,脚本 会 立刻 停止 执行 ,后 续 脚 本 内 容 不 会 
被 执行 。 


> Verify: 当 verify 命令 执行 失败 ,会 在 Selenium IDE 的 执行 日 志 区 域 打印 
一 条 失败 信息 ,然后 会 继续 执行 后 续 脚 本 内 容 。 
Assertions( 断 言 ) 类 型 > waitFor: 在 继续 下 一 个 命令 之 前 , waitFor 命令 会 等 待 某 个 条 件 真 实 





E 等 待 期 间 内 ,条 件 定义 的 情况 发 生 了 ,脚本 会 继续 执行 。 

* 在 等 待 期 间 内 ,条 件 定义 的 情况 没有 发 生 , 脚 本 会 在 Selenium IDE 的 执行 
日 志 区 域 打印 一 个 失败 信息 ,然后 会 继续 执行 后 续 的 脚本 内 容 。 

。 默认 情况 下 ,超时 的 判断 条 件 上 限 设 定 为 30 秒 ,在 Options 的 子 菜 单 
options 可 修改 超时 的 上 限 判断 时 间 要 求 


4.7 WEIJEHIUNBI SO Ez: E] 


在 录制 和 回放 实例 中 ,已 经 介绍 了 actions( 动 作 ) 类 型 命令 click 和 type. F ifii 4r 28 
Accessors( 存 储 器 ) 类 型 和 Assertions( 断 言 ) 类 型 命令 。 








4.7.1  waitForText , verifyText 和 assertText 命令 





waitForText 语句 在 测试 执行 时 用 来 判断 某 些 文本 是 否 显示 在 界面 中 , 若 界面 上 显示 
了 指定 文本 ,测试 程序 会 继续 执行 ; 若 等 待 一 段 时 间 后 ,界面 上 未 显示 指定 文本 ,测试 用 例 
会 被 设 定 为 执行 失败 状态 ,但 是 测试 脚本 依旧 会 继续 执行 。 

assertText 语句 在 测试 执行 时 用 来 判断 界面 上 的 某 些 文本 是 否 和 期 望 显示 的 文本 一 
致 , 若 一 致 则 测试 程序 会 继续 执行 ; 若 不 一 致 , 测 试用 例会 被 设 定 为 执行 失败 状态 ,并 且 不 
再 继续 执行 后 续 测 试 脚本 。 

verifyText 语句 在 测试 执行 时 用 来 判断 界面 上 显示 的 文本 是 否 和 期 望 显示 的 文本 相 一 
致 , 若 一 致 则 测试 程序 会 继续 执行 ; 若 不 一 致 ,测试 用 例会 设置 为 执行 失败 状态 ,但 测试 脚 
本 会 继续 执行 。 
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实例 如 下 : 

(1) 打开 Firefox 浏览 器 , 单 击 "工具 ”菜单 ,然后 单 击 Selenium. IDE 菜单 项 ,打开 
Selenium IDE 界面 , 设 定 录制 状态 。 

(2) 在 Selenium IDE 中 的 Base URL 输入 框 中 输入 *http://www. sogou. com", 

(3) 在 Firefox 浏览 器 地 址 栏 中 输入 “http://www. sogou. com” , f£ Enter 键 。 

CD 在 搜狗 首页 的 “网 页 ”两 个 字 上 , 单 击 鼠 标 右键 ,弹出 如 图 4-22 所 示 中 的 快捷 菜单 。 


mA) 
查看 元 素 (Q) 


鼠标 上 甚 浮 在 紫菜 单项 


Inspect in Eirepath 








(5) 将 鼠标 悬浮 在 弹出 菜单 中 的 Show All Available Commands, 弹 出 如 图 4-23 所 示 的 
子 菜 单 。 


open/ 

assertTitle 搜狗 搜索 引擎 - 上 网 从 搜狗 开始 
assertValue 

assertText css=span 网 页 

assertTable 


waitForTable 





(6) 单 击 “waitForText css— span 网 页 ”菜单 项 。 
CO 重复 上 面 的 第 (4) 步 和 第 (5) 步 , 单 击 “assertText ess span 网 页 ”的 菜单 项 。 


。41 。 





SS 
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(8) 重复 上 面 的 第 (4) 步 和 第 (5) 步 , 单 击 “verifyText ess span 网 页 ”的 菜单 项 。 
(9) Selenium IDE 脚本 区 域 生成 如 图 4-24 所 示 的 脚本 。 











Table 
Command Target Value 
open rÀ 
waitForText css=span 网 页 


图 4-24 


(10) 脚本 生成 后 , 单 击 “ 执 行 " 按 钮 六 可 .回放 脚本 ,执行 成 功 结果 如 图 4-25 所 示 。 


























图 4-25 


(11) 将 waitForText 和 verifyText 命令 行 脚本 中 的 “网 页 ”两 个 字 改 为 “网 ye" ,再 次 执 
行 脚本 ,脚本 执行 失败 ,测试 结果 如 图 4-26 Boon o 

(12) 将 脚本 中 的 waitForText 和 verifyText 命令 行 中 的 “网 ye” 改 为 “网 页 ”, 用 鼠标 拖 
动 assertText 命令 行 到 waitForText 命令 行 的 上 一 行 ,将 assertText 命令 行 的 “网 页 ” 改 为 
“网 ye” 两 个 字 , 再 次 执行 脚本 。 脚 本 执行 依旧 失败 ,但 是 发 现 此 次 失败 后 ,waitForText 和 
verifyText 语句 并 没有 被 执行 .如 图 4-27 所 示 。 

由 此 验证 waitForText 和 verifyText 语句 判断 失败 时 ,测试 程序 还 会 继续 执行 它们 后 
续 的 程序 代码 ,而 assertText 语句 判断 失败 时 ,不 会 继续 执行 测试 程序 的 后 续 程 序 代码 。 
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ATOUR. 3HES EL GERE 


verifyTexti JC X ETUR ER ERE 
yText | css-span | 网 ye | f7 J5 tt pre | | 
[error] Actual value "MF did not match. È 

[io] Executing: |esserTex Lec PAE, bre T etiki 61 AF AD 18 ALH AB RER RHEE 


Test case failed 








图 426 
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4.7.2 storeTitle 命令 和 echo 命令 


> storeTitle 命令 主要 用 于 将 网 页 的 title 内容 存储 在 变量 中 。 
> echo 命令 主要 用 于 常量 字符 串 和 变量 字符 串 的 打印 输出 ,特别 用 于 调试 脚本 时 输出 
脚本 的 状态 。 

实例 如 下 : 

A) 打开 Firefox 浏览 器 , 单 击 “ 工 具 " 菜 单 , 然 后 单 击 Selenium IDE 菜单 项 或 者 直接 按 
Ctrl 十 Alt 十 S 组 合 键 , 打 开 Selenium IDE 界面 , 设 定 为 录制 状态 。 

(2) 在 Selenium IDE 中 的 Base URL 输入 框 中 输入 *http://www. sogou. com", 

(3) 在 Firefox DJ VE ds Jb hb F5 rd A " http://www. sogou. com". f£ Enter 键 。 

(4) 在 脚本 编辑 区 域 , 输 入 如 图 4-28 所 示 的 脚本 。 

* open/ 命 令 表 示 在 Firefox 浏览 器 访问 http://www. sogou. com, 

。 storeTitle title 命令 行 表示 把 当前 网 页 的 title 属性 值 存储 到 名 为 title 的 变量 中 。 

* echo $ {title IRE Log 显示 区 域 打印 变量 title 中 的 变量 值 。 

(5) 执行 此 脚本 成 功 后 ,在 log 区 域 显示 出 echo 语句 执行 的 结果 ,打印 “搜狗 搜索 引擎 - 
上 网 从 搜狗 开始 ”, 如 图 4-29 所 示 。 








Table | Source Log Reference | Ul-Element | Rollup 
———À linfo] Playing test case storeTitieigecho 
Command T [info] Executing: lopen | /11 E 
ii ino] Executing: storeTi | e TT 输出 变量 存储 的 
koe , [info] i [echo | $(ttie, Title 内 容 
ee title. finfof echo: "IW - FIN: 
echo (title) [info] Test case 
图 4-28 图 4-29 


4.7.3 openWindow 命令 和 selectWindow 命令 





> open Window 命令 主要 用 于 打开 新 的 Firefox 浏览 器 窗口 。 
> selectWindow 命令 主要 是 用 于 选择 一 个 处 于 打开 状态 的 窗口 。 
为 了 简化 篇 幅 , 我 们 使 用 如 表 4-2 所 示 的 表示 Selenium IDE 的 脚本 。 

















表 4-2 
Command Target Value 
XXX yyy ZZZ 
脚本 逻辑 : 


CD 执行 open 命令 打开 一 个 浏览 器 窗口 A, 自 动 访问 http://www. sogou. com 首页 。 

(2) 执行 openWindow 命令 新 开 一 个 Firefox 浏览 器 窗口 B, 自 动 访问 网 址 http:// 
www. baidu. com; openWindow 命令 行 中 的 value 值 为 百度 首页 的 title 属性 (“百度 一 下 ， 
你 就 知道 ”) 。 

(3) 执行 selectWindow 命令 ,使 用 “百度 一 下 ,你 就 知道 ”关键 字 选 中 新 开 浏 览 器 窗口 
B, 在 浏览 器 B 中 的 百度 搜索 框 中 输入 字符 “baidu”。 


.44. 
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(4) 执行 selectWindow 命令 ,使 用 "搜狗 搜索 引擎 -上 网 从 搜狗 开始 ”( 搜 狗 首页 的 title 
属性 ) 选 中 浏览 器 窗口 A, 在 浏览 器 A 中 的 搜狗 搜索 框 中 输入 字符 “sogou”。 

实例 脚本 : 

在 Selenium IDE 的 Base URL H$ A “http://www. sogou. com". Selenium IDE 脚本 
如 表 4-3 所 示 。 






































表 4-3 
Command Target Value 
open / 
openWindow http://www. baidu. com 百度 一 下 ,你 就 知道 
selectWindow 百度 一 下 ,你 就 知道 
pause 3000 
tae ks baidu 
selectWindow 搜狗 搜索 引擎 -上 网 从 搜狗 开始 
type query Sogou 
更 多 说 明 


(1) openWindow 命令 后 面 有 两 个 参数 ,第 一 个 是 要 访问 的 URL, 第 二 个 是 打开 URL 
网 页 后 页 面 的 title 属性 值 。 

(2) selectWindow 命令 后 面 是 一 个 参数 ,需要 设 定 为 要 选中 窗口 的 title 属性 值 。 

(3) pause 3000 表示 暂停 3 秒 。 

(4). selectWindow 命令 执行 需要 1 秒 左 右 , 所 以 暂停 3 秒 以 等 待 程序 完成 选中 窗口 的 
操作 。 

(5) 此 实例 脚本 示范 了 如 何在 不 同窗 口 间 进行 切换 操作 。 


注意 日 Firefox 浏览 器 可 能 会 阻止 新 窗口 的 弹 窗 , 请 读者 单 击 允 许 即 可 。 


4.8 /ls 


Selenium IDE 插件 的 一 个 重要 作用 就 是 能 够 导出 多 种 编程 语言 的 自动 化 测试 脚本 , 通 
过 此 方式 就 可 以 实现 录制 脚本 和 其 他 编程 语言 脚本 的 转换 , 提高 自动 化 测试 工程 师 的 脚本 
编写 效率 。 当 测试 工程 师 不 知道 如 何 编写 某 些 自动 化 脚本 的 时 候 , 可 以 通过 录制 脚本 导出 
的 方式 来 获取 操作 页 面 元 素 的 脚本 程序 。 


4.8.1 导出 脚本 文件 


从 Selenium IDE 中 导出 脚本 程序 具体 步骤 如 下 。 

(1) 使 用 Selenium IDE 插件 打开 前 面 录制 的 sogou 搜索 脚本 。 

(2) 打开 脚本 后 ,在 Selenium IDE 中 单 击 "文件 ?菜单 ,将 鼠标 悬浮 在 Export Test Case 
As 菜单 项 上 方 , 单 击 Python 2/unittest/ WebDriver 菜单 项 ,如 图 4-30 所 示 。 


E 
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New Test Case — Ctl«N 














图 4-30 


G) 单 击 后 ,弹出 Windows 文件 保存 窗口 ,在 “文件 名 ”输入 框 中 输入 “SogouSearch, py". 
如 图 4-31 所 示 。 





2015/7/22 21:13 PY 文件 











(4) 单 击 “保存 ”按钮 ,脚本 保存 完毕 。 
(5) 使 用 文本 编辑 器 打开 SogouSearch. py 文件 ,可 查阅 导出 的 自动 化 测试 Python 代 
码 如 下 所 示 。 


于 - æ- coding: ut£ - 8 - * — 
from selenium import webdriver 


from selenium. webdriver. common. by import 


By 


from selenium. webdriver. common. keys import Keys 


from selenium. webdriver.support.ui import Select 
from selenium. common. exceptions import NoSuchElementException 
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from selenium. common. exceptions import NoAlertPresentException 


import unittest, time, re 


class Unit(unittest. TestCase): 
def setUp(self): 


self.driver - webdriver.Firefox() 


self.driver. implicitly wait(30) 


self.base url = "https://www. sogou. com/" 


self.verificationErrors = [] 
self.accept next alert - True 


def test unit(self): 
driver - self.driver 


driver.get(self.base url * "/") 


driver.find element by id("query").clear() 


driver.find element by id("query").send keys(u" J£ Z ft A 2) M iC" ) 


driver.find element by id("stb").click() 


def is element present(self, how, what): 


try: self.driver.find element(by = how, value = what) 
except NoSuchElementException as e: return False 


return True 


def is alert present(self): 


try: self.driver.switch to alert() 


except NoAlertPresentException as e: return False 


return True 


def close alert and get its text(self): 


try: 


alert - self.driver.switch to alert() 


alert text - alert.text 
if self.accept next alert: 
alert.accept() 
else: 
alert.dismiss() 
return alert text 
finally: self.accept next alert 


def tearDown(self): 
self.driver.quit() 


self.assertEqual([], self.verificationErrors) 





if name . 
unittest.main() 


将 上 述 代 码 中 的 self. driver = webdriver. Firefox O f£ gt JJ self. driver = webdriver. 


7 True 
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FirefoxCexecutable path = "c: W geckodriver") , 即 指明 Firefox 浏览 器 的 驱动 文件 (如 果 驱 
动 文件 设置 到 环境 变量 中 ,忽略 此 步 ) 所 在 路 径 , 然 后 即 可 以 成 功 执行 该 脚本 。 

在 导出 脚本 的 基础 上 进行 二 次 脚本 开发 会 事半功倍 ,此 方法 适合 初级 自动 化 测试 工程 
师 来 熟悉 WebDriver 常用 API, 可 将 常用 的 测试 操作 步骤 直接 转化 为 WebDriver 脚本 ,加 
深 对 常用 API 的 理解 。 


使 用 Selenium IDE 插件 导出 的 测试 脚本 并 不 是 完全 都 可 用 的 ,有 时 会 出 现 
少量 的 语法 错误 ， 需 自动 化 测试 工程 师 进行 调试 后 方 可 执行 。 


4.8.2 将 Selenium IDE 插件 中 的 某 行 命令 导出 为 Python 脚本 


具体 操作 步 又 如 下 。 

CD 在 Selenium IDE 的 Options 菜单 项 中 ,将 鼠标 悬浮 在 Clipboard Format 菜单 项 上 
Ji SX Ii "d" Python 2/unittest/WebDriver” 命 邻 。 

(2) 在 Selenium IDE 中 ,打开 前 面 录制 的 sogou 搜索 测试 脚本 。 

C3) 在 脚本 编辑 区 , 单 击 选中 如 图 4-32 所 示 的 脚本 行 。 





图 4-32 
(4) Fk Ci C 组 合 键 。 
(5) 打开 一 个 空白 的 写字 板 文件 , 按 Ctrl 十 V 组 合 键 可 看 到 如 图 4-33 所 示 的 Python 脚 
本 语句 。 


driver.find element by id("query").clear() 
driver.find element_by_id("query") .send_keys (u" 光 荣 之 路 自动 化 测试 ") 


图 4-33 


更 多 说 明 : 
此 方法 可 以 将 Selenium IDE 脚本 快速 转化 为 支持 的 特定 编程 语言 的 测试 代码 ,辅助 自 
动 化 测试 工程 师 生成 一 些 自己 并 不 太 熟 悉 的 测试 代码 。 


Ne 搭建 Python 环境 和 PyCharm 
POJE 集成 开发 环境 


在 搭建 Python 环境 前 , 先 说 明 一 下 ,笔者 这 里 使 用 的 Python 2. x 版 本 。 可 能 有 人 会 问 
了 ,Python 官网 已 经 更 新 到 3. x 了 ,为 什么 不 用 最 新 版 的 呢 ? 原因 是 Python 2. x 更 加 成 
熟 ,Python 3.x 完 全 相当 于 一 门 新 语言 ,语法 上 跟 Python 2.x 有 很 大 的 区 别 , 并 且 在 设计 上 
也 没有 考虑 向 下 兼容 ,而且 现在 大 部 分 第 三 方 库 . 书 和 资料 都 是 基于 2. x 版 本 的 ,这 些 已 经 
为 我 们 提供 了 丰富 的 资源 ,同时 也 由 于 Python 3. x 在 某 些 性 能 没有 Python 2. x 好 。 本 书 
中 笔者 均 是 基于 Python 2. 7. 7 版 本 来 讲解 的 。 

Python 语言 编写 的 Selenium 自动 化 测试 脚本 ,笔者 选择 在 PyCharm 集成 开发 环境 中 
运行 ,读者 也 可 以 选择 直接 在 文本 编辑 器 中 编写 ,然后 通过 CMD 执行 。 如 果 做 大 型 项 目 开 
发 ,推荐 大 家 使 用 Pycharm 工具 ,其 功能 很 强大 ,能 在 编写 程序 时 给 我 们 带 来 很 多 方便 , 特 
别 是 代码 补 全 ,可 调用 函数 查看 等 。 

本 书 所 有 的 环境 搭建 以 及 Selenium 脚本 编写 默认 都 是 基于 Windows 7 X64 系统 完成 ， 
读者 如 果 使 用 的 是 Windows 10 或 者 其 他 类 型 的 系统 ,本 书 中 部 分 内 容 可 能 不 匹配 ,请 读者 
自行 做 相应 修改 。 


5.1 BA iA EZ 


在 使 用 一 种 编程 语言 编写 程序 时 ,首先 需要 搭建 支持 这 个 编程 语言 的 开发 环境 ,本 节 先 
讲解 Python 环境 的 搭建 和 配置 。 


5.1.1 下 载 并 安装 Python 解释 器 
具体 操作 步骤 如 下 。 


(D 访问 https://www. python. org/ 。 

(2) 单 击 菜单 栏 中 的 Downloads, 出 现 如 图 5-1 所 示 的 界面 。 

(3) 任意 选择 一 个 Python 2. x 版 本 , 单 击 后 面 的 下 载 图 标本 Download. 

(4) 选 好 Python 版 本 并 进入 其 下 载 界面 后 ,选择 适合 的 平台 及 版 本 位 数 ( 笔 者 的 系统 
为 Windows 7 X64) ,直接 单 击 链接 就 可 以 进行 下 载 , 如 图 5-2 所 示 。 

O) 下 载 完 后 会 得 到 一 个 扩展 名 为 msi 的 安装 程序 ,例如 | 吾 prthon277amd64msi ,双击 该 
安装 程序 ,然后 一 直 单 击 “ 下 一 步 ” 按 钮 进行 安装 ,安装 完成 后 在 操作 系统 的 C 盘 会 出 现 一 
个 Python27 目录 d Pythonz7 

至 此 ,完成 Python 开发 环境 的 安装 。 
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About Downloads Documentation Community 


Download the latest version for W 


Download Python 3.5.2 | Download Python 2.7.12 
which version to use f 


oking for Python with a different OS 





Looking for a specific release? TERR 
Python 版 本 选择 列表 
Python releases by version number 


Release version. Release date | c 

Python 3.4.5 2016-06-27 4& Download R 

Python 3.5.2 2016-06-27 4& Download R 

Python 2.7.12 2016-06-25 4& Download F 

Python 3.4.4 2015-12-21 4& Download R 

Python 3.5.1 2015-12-07 4& Download R 
图 5-1 


Download 


This is a producti 





We currentty support these formats for download 











mien rernm 321 


È pnhev27Tamdetma 
-ETR Loisa me. 


5.1.2 配置 Python 环境 


具体 步 又 如 下 。 

CD 在 “计算 机 ”桌面 图 标 上 单 击 鼠标 右键 ,在 弹出 的 菜单 列表 中 , 单 击 “ 属 性 ”, 如 图 5-3 
所 示 。 

(2) 在 弹出 的 系统 对 话 框 的 左 侧 导 航 栏 中 , 单 击 “高 级 系统 设置 "项 国 可 snas , 调 出 “ 系 
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统 属性 ”配置 对 话 框 ,如 图 5-4 所 示 。 

(3) 进入 “系统 属性 "窗口 的 “高 级 "选项 卡 , 单 击 对 话 框 右 
下 角 的 “环境 变量 ”, 调 出 系统 环境 变量 配置 界面 ,如 图 5-4 
所 示 。 

(4) 在 系统 环境 变量 配置 对 话 框 中 ,在 系统 变量 列表 中 找 
到 变量 名 为 *Path” 的 行 ,双击 该 行 , 调 出 “编辑 系统 变量 "对话 
框 ,如 图 5-5 Bras o 

(5) 在 “编辑 系统 变量 ”对话 框 中 的 “变量 值 ” 行 右边 的 输入 NE 
框 中 ,在 最 前 面 添加 Python 的 安装 路 径 *C:\Python27;”, 然 后 图 
单 击 “ 确 定 ” 按 钮 后 完成 Python 环境 配置 步骤 ,如 图 5-6 所 示 。 




















































cae zz 
FuGksswn. DUAOUSAST- Msisistretor 的 用 户 变量 
m 
视觉 阔 果 ， 处 理 器 计划 ， 内 存 使 用 ， 以 及 虚 扣 内 存 — 
mPp WISERPROFIL EX\AppDate\Local\Tenp 
MERES 
STERAXMATHE 
iem 
Birinin E in 3 
系统 启动 、 系 统 失 败 和 i 同 式 信息 ANALYSIS PATH — C Mrogrum Files (x66)MIP\Losdh - 3 
asl log Destinationzfile 
CLASSPATH JAVA HOMEX\Lib\dt. jar  XJAVA MO. 
a CE RA 
Cem CC RO | 
图 54 








































a os Windows NT 
C: Veurl-T. 4T. 1-win32-ningeVbin.| Path C: Veur1-T. 4T. 1-vin32-ningeVbin; (3 
EIE. EAT. CN. VIS. VBE: PATENT CON; EXE; BAT. CHD; VIS; YBE; 
Ama. [Pmysss ar ame 0 0 0 0 0 0 0 030 7] 
(sion... Ceo | 
图 5-5 E 5-6 
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Python 安装 路 径 后 面 有 一 个 分 号 (;), 表 示 路 径 间 的 分 隔 符 。 


(6) 在 “运行 "输入 框 中 输入 “cmd”, 然 后 直接 按 Enter 键 ,如 图 5-7 所 示 , 弹 出 cmd 对 话 
框 ,如 图 5-8 所 示 。 








Eg EEA AWindows\ ystem3n nd ere E NN 


F 


1.76011 


t Corporation 






(7) 在 弹出 的 cmd 对 话 框 中 输入 “python”, 按 Enter 键 后 会 显示 如 图 5-9 所 示 的 信息 ， 
表示 Python 环境 配置 成 功 。 





lii EA: C\Windows)system32\cmd.exe - python boa Sä 
icrosoft Window V 7681] 
RR 权 所 有 <e> 2009 Mi oft Corporation 


2: sers\Adninistrator>python 
7.7 Cdefault, Jun 1 2814, 14 7 -1588 64 bit <AMD64)] on vin| 


"help", "copyright", edits” or e for more information. 





5.1.3 安装 pip 


ds 





- 般 Python 默认 会 自 带 一 个 低 版 本 的 pip 工具 ,如 果 读 者 选择 使 用 默认 的 pip TR, 
可 以 忽略 本 节 , 只 需要 将 “C:NPython27\Scripts” 目 TM 系统 的 Path 环境 变量 中 , 即 可 
在 CMD 下 直接 使 用 ,添加 方 人 “配置 Python 环境 变 
具体 操作 步骤 如 下 
(1) 在 浏览 器 中 访问 网 址 https: / /pypi. python. org/pypi/pip, 下 载 pip 源码 包 , 如 图 5-10 
所 示 o 











Fie 
pI-3 1 2-py2 py3-none-amy whi (moS, pgp) 


<4 pip 





PRP 





图 5-10 


(2) 单 击 图 5-10 所 示 的 pip 源码 包 , 下 载 pip 包 , 等 待 下 载 完 成 后 ,会 得 到 一 个 扩展 名 
为 gz 的 压缩 文件 ,比如 “pip-8. 1. 2. tar. gz”. 

(3) 解压 “pip-8. 1. 2. tar. gz” 文 件 , 保 存 到 imi pip-8. 1.2 目录 下 ,在 cmd 命令 窗口 下 ， 
使 用 cd 命令 将 当前 的 工作 目录 切换 到 “D:\pip-8.1.2”, 然 后 输入 “python setup. py install" 
并 按 Enter 键 ,安装 pip 工具 ,如 图 5-11 Bros. 

(4) 等 待 pip 安装 完成 .安装 成 功 后 的 界面 如 图 5-12 所 示 。 
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E noe EA: C\Windows\system3zwmd exe 





(5) 将 “C:\Python27\Scripts” 路 径 添加 到 系统 的 Path 环境 变量 中 ,添加 方法 参照 “ 配 


置 Python 环境 变量 ”, 这 里 不 再 袭 述 


5.2 KE Ju E 发 环境 P rm 


PyCharm 是 比较 好 用 的 Python 编辑 器 ,不 仅 功能 强大 ,而且 还 可 以 跨 平 台 。 本 书 所 有 
实例 默认 都 使 用 该 软件 开发 ,本 节 主 要 讲解 此 软件 的 安装 步骤 。 

(1) 访问 网 址 http://www. jetbrains. com/pycharm/download/ # section 

(2) 在 打开 的 网 页 中 ,选择 社区 版 本 进行 下 载 (免费 ), 如 图 5-13 所 示 。 

(3) 等 待 几 分 钟 ,下载 完 成 后 会 得 到 一 个 exe 安装 文件 “pycharm-community-2016. 2. 





windows。 





3. exe", 






(4) XGli" pycharm-community-2016. 2. 3. exe" 装 文件 进行 安装 ,然后 只 需要 
直 单 击 Next 按钮 ,期 间 需 要 根据 读者 自 己 的 操作 系统 位 数 完成 如 图 5-14 的 操作 。 安 装 成 


功 后 ,会 在 操作 系统 桌面 上 出 现 一 个 如 图 5-15 所 示 的 快捷 启动 图 标 。 


Bl PyCharm Community Edition Setup. - 


&m poene 





Community | | oem 根据 操作 


Lightweight IDE 
for Python & Scientific 
单 击 下载 、 development 


DOWNLOAD 


图 5-13 图 

(5) 双击 图 5-15 所 示 的 图 标 ,启动 PyCharm, 第 一 次 启动 会 出 现 如 图 5-16 所 示 的 界面 ， 

直接 单 击 OK 按钮 即 可 。 等 待 几 秒 后 ,会 弹出 如 图 5-17 所 示 的 对 话 框 , 根 据 读 者 喜好 自行 
修改 或 者 直接 单 击 Skip 按钮 跳 过 此 步 。 


e 
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You can import your settings from a previous version of PyChara. 


X want to import my settings from a custom locatio 


Specify config folder or installation home of the previous version of PyChara: 


Q1 do not have a previous version of PyChar or I do not want to import ay settings 


(mp 单 击 OK 技 包 





图 5-16 


“PyCharm Community Edition initial Config.. ESI 

ET 
IDE theme: Intelii Bü 
Editor colors and fonts: 


> Click to preview 
You can use Fle | Settings to configure any of these setings iater 








EX 


(6) 首次 使 用 ,首先 需要 进行 新 工程 的 创建 ,在 如 图 5-18 所 示 的 界面 中 单 击 Create 
New Project 图 标 ,出 现 如 图 5-19 所 示 的 界面 。 







PyCharm Community Edition 
A pee dd 
Doe 
A Check out from Version Control « 








第 一 次 启动 PyCharm 成 功 后 的 界面 








© Configure + Get Help ~ 


更 多 说 明 : 

PyCharm 会 自动 扫描 已 经 安装 过 的 Python 解释 器 ,然后 显示 在 Interpreter 下 拉 选 择 
框 中 ,如 果 没 有 显示 ,读者 可 以 自行 单 击 后 面 的 设置 按钮 E] ,进行 Python 解释 器 的 选择 。 

(7) 在 新 工程 编辑 界面 设置 好 Python 新 工程 存放 路 径 以 及 新 工程 需要 的 Python 解释 
器 ,如 图 5-19 所 示 , 然 后 单 击 Create 按钮 ,等 几 分 钟 , 即 可 进入 PyCharm 集成 开发 环境 界 
面 ,如 图 5-20 所 示 。 
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选择 此 工程 需要 的 Python 解释 器 版 本 


添加 新 的 Python 解释 器 

















Python Console Terminai  f&TODO 











图 5-20 


说 明 : 
Pycharm 工具 的 默认 程序 文件 或 工程 的 编码 为 UTF-8。 


5.3 ku MU E 


具体 操作 步骤 如 下 。 

CD 选择 File New Project 命令 ,如 图 5-21 所 示 。 

(2) 弹出 新 建 Python 工程 对 话 框 ,在 Location 输入 框 中 输入 新 工程 存放 路 径 , 或 者 直 
接 单 击 浏览 按钮 进行 选择 路 径 , 如 图 5-19 所 示 。 在 Interpreter 选择 框 中 选择 新 工程 需要 的 
Python 解释 器 ,或 者 单 击 后 面 的 设置 按钮 添加 新 的 Python 解释 器 , 单 击 Create 按钮 ,如 
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Project] - PyCharm Community Edition 
Edit View Navigate Code Refactor Run Iools VCS V 








图 5-19 所 示 o 
(3) 在 工程 名 上 单 击 鼠 标 右键 ,在 弹出 的 菜单 列表 中 选择 New 一 File( 也 可 以 选择 创建 
目录 或 Python 包 等 ) ,如 图 5-22 所 示 。 
a T E 
Eile Edit View Navigate Code Refactor Run Jools VCS Window Help 
创建 Python 文件 
















B File 
FI 创建 目录 cute D Directory 







O copy 中 建 pyth 一 Cake 和 © Python Package 
$ Copy Path 创建 人 fi Python File. 
È Copy as Plain Text È Jupyter Notebook 
& Copy Reference Cul«AlteShift«c — [E HTML File 
v cuv 







Alt+F7 
Find in Path Cil Shift«F. 


图 522 






(4) 在 弹出 的 文件 编辑 对 话 框 中 输入 文件 名 ,如 “test. py”, 单 击 OK 按钮 ,完成 Python 
文件 的 创建 ,如 图 5-23 所 示 。 





图 5-23 


(5) 完成 以 上 步 又 以 后 ,在 新 建 的 Python 工程 下 会 看 到 新 创建 的 文件 “test. py”, 单 击 
选中 这 个 文件 ,可 以 将 光标 切换 到 该 文件 编辑 区 域 ,插入 一 行 著名 的 Hello World 代码 
“print "Hello World!"”, 如 图 5-24 所 示 o 
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(6) 在 PyCharm 工具 栏 中 , 单 击 Run, 在 弹出 的 菜单 列表 中 单 击 Run 命令 ,弹出 一 个 运 
行文 件 选择 界面 ,选择 刚 创建 的 Python 文件 ,如 图 5-25 所 示 。 


or [fun] 196. ves Mio Help 











| 
Q.D» Edit Configurati 
-一 
图 5-25 
(7) 在 PyCharm 的 Console 窗口 中 可 看 到 程序 的 输出 结果 为 “Hello World!”, 如 


图 5-26 所 示 。 
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本 章 主要 讲解 WebDriver 的 安装 与 配置 方法 ,请 读者 按照 本 章节 的 内 容 安装 和 配置 好 
WebDriver 的 运行 环境 ,以 便 在 后 续 章 节 中 讲解 基于 WebDriver 实例 时 ,能 及 时 执行 及 查看 
结果 。 

本 书 以 笔者 撰 稿 时 最 新 的 Selenium(3. 0. 2) 版 本 为 例 , 介 绍 在 Python 中 如 何 安装 及 使 
用 ,具体 操作 步骤 如 下 。 


6.1 ANE 


(1) 安装 好 Python pip 工具 后 ,尝试 直接 在 cmd 下 输入 “pip install selenium”, 如 图 6-1 所 
示 , 如 果 成 功 , 则 直接 跳 转 到 第 (5) 步 开始 执行 








] 9m 
管理 员 : CAWindowsysystem32Vcmd.exe 





1 
icre 


(2) FAX Selenium 离线 安装 包 ,访问 网 址 https://pypi. python. org/pypi/ selenium, 选 
择 扩展 名 为 gz 的 源码 包 进 行 下 载 , 如 图 6-2 所 示 。 


File sir P dkselenium Bi skitit ype 1 
selenium-3.0 2-py2 pyg any whi (md5) Python Wheel 
图 62 


G) 下 载 完 以 后 会 得 到 一 个 “selenium-3. 0. 2. tar. gz” 离 线 安装 文件 ,解压 该 文件 到 任意 
目录 。CMD 下 通过 cd 命令 将 当前 的 工作 目录 切换 到 “setup. py” 文 件 所 在 的 目录 ,如 图 6-3 
所 示 。 

(4) 然后 cmd 下 执行 “python setup. py install” 命 令 进 行 安装 ,安装 成 功 后 的 界面 如 
图 6-4 所 示 。 

(5) 安装 成 功 后 , cmd 下 输入 “python” 回 车 ,进入 Python 交互 模式 ,执行 “import 
selenium”, 如 果 没 有 报错 ,说 明 Selenium 已 经 安装 成 功 ,如 图 6-5 所 示 。 
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— 将 工作 目 3 
一 wssetup.py" 文 件 所 在 目 
录 


2016/11/21 


Extracting ium-3. 0. 2-py2. 7. egg to c: Wython27 VL ibVsite-package 
dding se 1.0.2 to easy pth file 


Installed c:\python27\lib' ages\selenium-3. 0. 2-py2. 7. egg 


essing dependencie: e 0 
d pr ng dependencie: elenium=3. 0. 2 


c Windows [版 本 6. 1. 7601] 
版 权 所 有 (c) 2009 Microsoft Corporation. ffüBidibURI. 


bit (Intel)] on win32 
nformation 


成 功 





测试 目标 : 

使 用 Firefox 浏览 器 验证 WebDriver 是 否 可 用 

测试 用 例 步骤 : 

(1) 在 Firefox 浏览 器 中 打开 搜狗 首页 

(2) 在 搜索 输入 框 中 输入 “光荣 之 路 自动 化 测试 ” 

(3) 单 击 “ 搜 索 ” 按 钮 。 

(4) 页 面 显示 搜索 结果 

环境 准备 : 

(1) 使 用 Firefox 浏览 器 执行 Selenium 3. x 编写 的 自动 化 测试 脚本 时 .需要 从 https:// 
github. com/mozilla/geckodriver/releases 网 址 根据 读者 操作 系统 类 型 及 浏览 器 位 数 (64 位 
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驱动 兼容 32 位 Firefox 浏览 器 ) 下 载 对 应 的 WebDriver 操作 Firefox 浏览 器 的 驱动 程序 ,如 
图 6-6 所 示 。 





v0.14.0 


Bl AutomatedTester released this 2 days ago - 3 commits to master since this release 


Changed 
* Firefox process is now terminated and session ended when the last window is closed 
* WebDriver library updated to version 0.20.0 

Fixed 


* Stacktraces are now included when the error originates from within the Rust stack 
* HTTPD now returns correct response headers for Content-Type and Cache-Control thanks to 





Gjugglinmike 
Downloads 
国 geckodriver-v0.14.0-arm7hf.tar.gz 197 MB 
国 geckodriver-v0.14.0-linux32.tar.gz 181 MB 
Uf geckodriver-v0.14.0-linux64.tar.gz 175 MB 
UI geckodriver-v0.14.0-macos.tar.gz 124 MB 
Œ geckodriver-v0.14.0-win32 zip n Ra 216 MB 
选择 适合 自己 操作 系统 的 版 本 进行 下 载 
国 geckodriver-v0.14.0-win64.zip 213MB 
D Source code (zip). 
图 6-6 


(2) 下 载 后 解压 到 geckodriver. exe 文件 ,将 该 文件 保存 到 本 地 硬盘 任意 位 置 ,比如 


DF. 


测试 脚本 程序 : 


# encoding = utf - 8 
from selenium import webdriver 
import time 


£ 通过 executable path 参数 指明 Firefox 驱动 文件 所 在 路 径 

driver = webdriver.Firefox(executable path- "c:\\geckodriver") 

# driver = webdriver.Chrome(executable path- "c:||chromedriver ") 

# 打开 搜狗 首页 

driver.get("http://www. sogou. con" ) 

# WB A EEHAMIT 

driver.find element by id("query" ).clear() 

# EB LA ie dg A "光荣 之 路 摇动 化 测 武 ” 

driver.find element by id("query" ).send keys(u" 光 荣 之 路 自动 化 测试 " ) 
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# 单 击 "Is iet 

driver.find element by id("stb").click() 

# FRIE 

time. sleep(3) 

# iB ih RE 

driver. quit() 

PyCharm 中 执行 该 脚本 ,会 看 到 程序 自动 启动 浏览 器 ,访问 搜狗 首页 ,并 在 搜索 输入 框 
中 输入 搜索 关键 内 容 “ 光 荣 之 路 自动 化 测试 ”, 单 击 搜索 按钮 后 展示 搜索 结果 ,3 秒 后 自动 退 
出 浏览 器 。 

更 多 说 阴 : 

从 Selenium 3. x 版 本 开始 ,webdriver/firefox/ webdriver. py 程序 文件 中 的 _ init _. 
py 文件 中 ,设置 executable. path =" geckodriver". 而 Selenium 2. x 是 executable path = 
"wires" ,所 以 使 用 Selenium 3. x 编写 的 自动 化 测试 脚本 ,使 用 Firefox 浏览 器 测试 时 需要 指 
HH Firefox 浏览 器 驱动 程序 "geckodriver. exe” 文 件 所 在 路 径 。 

问题 及 建议 : 

建议 Firefox 浏览 器 在 安装 时 使 用 默认 安装 路 径 。 如 果 使 用 了 自 定义 安装 路 径 , 可 能 
无 法 找到 Firefox. exe 文件 来 启动 执行 此 测试 脚本 的 Firefox 浏览 器 。 

报错 1: 


Exception in thread "main" org. openga. selenium. WebDriverException: Cannot find firefox binary 
in PATH. Make sure firefox is installed. 


解决 办 法 : 
在 driver = webdriver. FirefoxCexecutable path = "c:\\geckodriver" ) 这 行 代码 前 一 
行 增加 如 下 代码 行 : 


os. environ["webdriver. firefox. driver"] = "C:\Program Files (x86)\Mozilla Firefox\firefox. 


exe 


Hp .*C; NW ProgramFiles (x86)\\Mozilla Firefox W firefox. exe" (64€ firefox. exe 文件 所 在 
的 路 径 ,读者 须根 据 自己 机 器 上 firefox. exe 文件 所 在 的 路 径 进行 修改 。 

报错 2: 

WebDriverException: Message: Expected browser binary location, but unable to find binary in 


default location, no 'moz:firefoxOptions. binary' capability provided, and no binary flag set on 
the command line 


解决 方法 : 
脚本 顶部 导入 FirefoxBinary 模块 : 


from selenium. webdriver.firefox.firefox binary import FirefoxBinary 
修改 启动 浏览 器 的 代码 如 下 + 
binary = FirefoxBinary('D: V MFirefoxPortable V MFirefox.exe') 


driver webdriver.Firefox(firefox binary - binary, 
executable path = r"c:Mgeckodriver") 
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6.3 各 浏览 器 驱动 的 使 用 方法 


Selenium 3. x 版 本 开始 不 再 提供 默认 浏览 器 支持 ,所 有 浏览 器 都 是 通过 各 个 浏览 器 官 
方 提供 相应 的 浏览 器 驱动 进行 支持 ,这 使 得 运行 在 各 种 浏览 器 上 的 自动 化 测试 更 稳定 。 

除了 6.2 节 中 直接 通过 executable_path 参数 指明 支持 对 应 浏览 器 的 驱动 程序 文件 方 
法 外 ,读者 还 可 以 创建 一 个 目录 (比如 D:\driver\ A) ,把 不 同 浏览 器 的 驱动 文件 均 放 到 该 
目录 中 (比如 geckodriver. exe (Firefox 浏览 器 )、chromedriver. exe ( Chrome 浏览 器 )、 
MicrosoftWebDriver. exe(Edge 浏览 器 ) , IEDriverServer. exe E 浏览 器 ) ,operadriver. exe 
(Opera 浏览 器 ) 等 ,然后 将 该 目录 (比如 D:\driver\ 目 录 ) 添 加 到 系统 环境 变量 path 中 ， 
WebDriver 在 启动 浏览 器 时 ,会 自动 到 环境 变量 中 设 定 的 路 径 中 寻找 相应 的 驱动 文件 。 





LAw 在 本 书 中 ,笔者 将 采用 6.2 节 实例 程序 中 介绍 的 添加 浏览 器 驱动 的 方式 , 仅 
注意 局 是 为 了 更 灵活 。 


NL. 单元 测试 框架 的 使 用 介绍 


Python 语言 编写 的 WebDriver 测试 脚本 通常 使 用 单元 测试 框架 来 运行 ,所 以 了 解 单元 
测试 框架 的 基本 方法 和 单元 测试 框架 的 使 用 技巧 是 很 有 必要 的 。 


7.1 WES sw: 

单元 测试 (Unit Testing) 是 指 在 计算 机 编程 中 ,针对 程序 模块 (软件 设计 的 最 小 单位 ) 
来 进行 正确 性 检验 的 测试 工作 。 

单元 测试 的 特点 如 下 : 

» 程序 单元 是 应 用 的 最 小 可 测试 部 件 ,通常 基于 类 或 者 类 的 方法 进行 测试 。 

> 程序 单元 和 其 他 单元 是 相互 独立 的 。 

> 单元 测试 的 执行 速度 很 快 。 

> 单元 测试 发 现 的 问题 ,相对 容易 定位 。 

> 单元 测试 通常 由 开发 人 员 来 完成 。 

> 通过 了 解 代码 的 实现 逻辑 进行 测试 ,通常 称 之 为 白 盒 测 试 。 


7.2 W'l C33 单元 测试 框架 


Python 语言 中 有 很 多 单元 测试 框架 和 工具 ,而 unittest 单元 测试 框架 作为 标准 Python 
语言 中 的 一 个 模块 ,是 其 他 框架 和 工具 的 基础 ,一 般 的 Python 版 本 都 会 自 带 该 模块 ,而 对 
于 自动 化 测试 工程 师 来 说 ,掌握 该 框架 的 使 用 技巧 就 显得 尤为 重要 。 





unittest 被 称 作 Python 版 本 的 JUnit, 由 Kent Beck 和 Erich Gamma 开发 ,有 时 也 被 叫 
做 “PyUnit”。 主 要 用 于 Python 语言 程序 的 单元 测试 。 

unittest 框架 拥有 支持 自动 化 测试 ,测试 用 例 间 共享 setUp( 实 现 测试 前 的 初始 化 工作 ) 
和 shutDown( 实 现 测试 结束 后 的 清理 工作 ) 代 码 块 ,集合 所 有 的 测试 用 例 并 且 将 测试 结 
独立 地 展示 在 报告 框架 中 的 特性 ,在 一 组 测试 中 ,通过 unittest 框架 提供 的 类 很 容易 支持 它 
的 这 些 特性 。 


7.2.2 unittest 框架 的 4 个 重要 概念 
官方 文档 给 出 了 unittest 框架 中 4 个 重要 的 概念 ,介绍 如 下 。 








1. test fixture( 测 试 固件 ) 

一 个 test fixture 代表 一 个 或 多 个 测试 执行 前 的 准备 动作 和 测试 结束 后 的 清理 动作 , 例 
如 ,创建 数据 库 连 接 、 启 动 服务 进程 ,测试 环境 的 清理 或 者 关闭 数据 库 连 接 等 。 

2. test case( 测 试用 例 ) 

一 个 test case 就 是 一 个 最 小 测试 单元 ,也 就 是 一 个 完整 的 测试 流程 。 针 对 一 组 特殊 的 
输入 进行 特殊 的 验证 与 响应 。 通 过 继承 unittest 提供 的 测试 基 类 (TestCase) ,可 以 创建 新 
的 测试 用 例 。 

3. test suite( 测 试 套件 ) 

一 个 test suite 就 是 一 组 测试 用 例 ,一 组 测试 套件 或 者 两 者 共同 组 成 的 集合 。 它 的 作用 
是 将 测试 用 例 集合 到 一 起 ,然后 一 次 性 执行 集合 中 所 有 的 测试 用 例 。 

4. test runner( 测 试 运 行 器 ) 

一 个 test runner 由 执行 设 定 的 测试 用 例 和 将 测试 结果 提供 给 用 户 两 部 分 功能 组 成 。 


7.2.3 ”单元 测试 加 载 方 法 


在 unittest 单元 测试 框架 中 ,提供 了 两 种 单元 测试 的 加 载 方法 : 

(1) 直接 通过 unittest. main() 方 法 加 载 单元 测试 的 测试 模块 ,这 是 一 种 最 简单 的 加 载 
方法 ,所 有 的 测试 方法 执行 顺序 都 是 按照 方法 名 的 字符 串 表示 的 ASCII 码 升序 排序 。 

(2) 将 所 有 的 单元 测试 用 例 (Test Case) 添 加 到 测试 套件 (Test Suite) 集 合 中 ,然后 一 次 
性 加 载 所 有 测试 对 象 。 


7.2.4 WAMA 


软件 测试 中 最 基本 的 组 成 单元 是 测试 用 例 ,unittest 框架 通过 TestCase 类 来 构建 测试 
用 例 , 并 要 求 所 有 自 定义 的 测试 类 都 必须 继承 该 类 , 它 是 所 有 测试 用 例 的 基 类 , 传 入 一 个 测 
试 方法 名 ,将 返回 一 个 测试 用 例 实例 。TestCase 的 子 类 中 实现 测试 用 例 的 代码 既 可 以 单独 
运行 ,也 可 以 和 其 他 测试 用 例 构 成 测试 用 例 集 , 然 后 批量 执行 。 

TestCase 作为 unittest 单元 测试 框架 中 测试 单元 的 运行 实体 ,单元 测试 脚本 编写 员 可 
以 通过 它 派生 出 自 定义 的 测试 过 程 与 方法 。TestCase 子 类 从 父 类 继承 的 几 个 特殊 的 方法 ， 
在 测试 用 例 执行 时 均 会 被 依次 执行 。 

TestCase 类 中 定义 的 几 个 特殊 方法 如 下 。 

(1) setUp(): 每 个 测试 方法 运行 前 运行 ,测试 前 的 初始 化 工作 。 

(2) tearDownO ; 每 个 测试 方法 运行 结束 后 运行 ,测试 后 的 清理 工作 。 

(3) setUpClass O : 所 有 的 测试 方法 运行 前 运行 ,单元 测试 前 期 准备 , 必须 使 
@classmethod 装饰 器 进行 修饰 ,setUp() 函数 之 前 执行 ,整个 测试 过 程 只 执行 一 次 。 

(4) tearDownClass(): 所 有 的 测试 方法 运行 结束 后 执行 ,单元 测试 后 期 清理 ,必须 使 
@classmethod 装饰 器 进行 修饰 ,tearDown() 之 后 执行 ,整个 测试 过 程 只 执行 一 次 。 

最 简单 的 测试 用 例 只 需要 通过 覆盖 runTest() 方 法 来 执行 自 定 义 的 测试 代码 ,这 种 称 
为 静态 方法 ,如 下 面 的 实例 : 
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#encoding - utf - 8 
import unittest 
import random 


class TestSequenceFunctions(unittest. TestCase) : 
def setUp(self): 
# Witt aS 
self.seq - range(10) 


def runTest(self): 
* 从 序列 sea th B BLUE oU 
element = random. choice(self. seq) 
# JeuEB SLIC SR i KE FAKE 


self.assertTrue(element in self.seq) 


class TestDictValueFormatFunctions(unittest. TestCase): 
def setUp(self): 
self.seq - range(10) 


def test shuffle(self): 
* BÜBLITALIR seq 的 顺序 
random. shuffle(self.seq) 
self.seq. sort() 
self.assertEqual(self.seq, range(10)) 
# JeuET ET RAHIM h T TypeError 异常 
self.assertRaises(TypeError, random. shuffle, (1, 2, 3)) 


if name  -- ' main ': 


unittest. main( ) 


如 果 要 在 unittest 单元 测试 框架 中 构造 上 述 测试 类 的 一 个 实例 ,需要 按 testCase = 
TestSequenceFunctions( ) 这 行 代码 实现 ,并 且 一 个 测试 用 例 通常 只 能 对 测试 模块 中 一 个 方 
法 进行 单元 测试 ,如 果 要 对 测试 模块 中 多 个 方法 进行 单元 测试 ,就 需要 构造 多 个 执行 测试 
类 ,就 如 上 例 中 的 TestSequenceFunctions 类 和 TestDictValueFormatFunctions 类 ,而 对 于 
同一 测试 模块 ,测试 用 例 间 可 能 有 着 相同 的 初始 状态 ,如 果 还 是 采用 上 述 方法 就 会 出 现 很 多 
元 余 代码 ,并 且 还 是 一 项 费时 的 枯燥 工作 。 

unittest 框架 针对 这 一 问题 ,给 出 了 一 种 动态 的 解决 办 法 ,脚本 编写 人 员 只 需要 写 一 个 
测试 类 来 完成 对 整个 测试 模块 的 单元 测试 ,而 初始 化 工作 直接 在 setUp() 方 法 中 完成 ,资源 
的 释放 等 清理 工作 直接 在 tearDown( ) 方 法 中 完成 即 可 ,这 种 方法 规定 所 有 需要 被 执行 的 测 
试 方法 都 必须 以 “test" 开 头 , 具 体 实 例如 下 。 

实例 脚本 程序 : 

# encoding- utf - 8 

import unittest 


# BH 
class myclass(object): 
(Qclassmethod 
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def sun(cls, a, b): 
returna + b £jJ4 f [E A SBIT A mtk ME 


(àclassmethod 
def sub(cls, a, b): 
returna - b# 将 两 个 伟人 参数 进行 相 减 操作 


class mytest(unittest. TestCase) : 
@classmethod 
def setUpClass(cls): 
ripe FERE I nnn 
print" ---- setUpClass" 


(à classmethod 
def tearDownClass(cls): 
rng gg a pg (p nm 
print " ---- tearDownClass" 


# WUTA 

def setUp(self): 
self.a = 3 
self.b- 1 
print " -- setUp" 


# 退出 游 理 工作 
def tearDown(self): 
print" -- tearDown" 


# 具体 的 测试 用 例 , — E EDI test 开头 

def testsum(self): 
# iE R L RIA EA 
self.assertEqual(myclass.sum(self.a, self.b), 4, 'test sum fail') 


def testsub(self): 
EON HECEXIMIAR E 
self.assertEqual(myclass.sub(self.a, self.b), 2, 'test sub fail') 


if name  -- ' main ': 


unittest.main() # 启动 单元 测试 


在 PyCharm 工具 中 执行 该 测试 脚本 。 
测试 结果 : 


C:\Python27\python. exe D: /PythonProject/test/run test.py 
—--—-—- setUpClass 

—- setUp 

—- tearDown 

—- setUp 

—- tearDown 
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—--- tearDownClass 


Ran 2 tests in 0.002s 


OK 


测试 结果 说 明 : 

从 输出 结果 看 出 ,setUpClass() 和 tearDownClass() 方 法 在 整个 测试 类 运行 过 程 中 只 被 
执行 了 一 次 ,而 setUp() 和 tearDown() 方 法 在 每 个 测试 方法 执行 前 和 执行 后 均 被 调用 ,被 
执行 了 多 次 。 在 测试 结果 输出 中 ,出 现 了 两 个 点 (.. ) ,这 表示 测试 类 mytest 中 两 个 测试 方 
法 testsum() 和 testsub() 均 被 成 功 执行 ,一 个 点 表示 一 个 测试 方法 。 

说 明 : 

在 PyCharm 工具 中 执行 单元 测试 代码 ,输出 结果 信息 有 可 能 会 出 现 乱 序 ,如 图 7-1 所 
示 , 此 时 读者 可 以 直接 在 cmd 中 执行 . py 文件 即 可 解决 此 问题 。 


C:\Python27\python. eze D: /PythonPro ject /book/Cal c/7-2-4-02. 
——setlpClass 





tearbom 
Ran 2 tests in 0. 000s 
—setlip 


aomi +> 
| 
| 
| 
| 
| 
| 
| 
| 


—tearDom 
OK 
—tearDomClass 


Process finished with exit code 0 
图 7-1 


更 多 说 明 : 

CD 有 时 在 测试 结果 输出 中 会 出 现 *E” 和 *F” 字 符 的 情况 ,这 说 明 测试 用 例 执行 失败 或 
发 生 了 异常 ,下 面 分 别 介绍 一 下 这 两 个 字符 出 现 的 情况 。 按 如 图 7-2 所 示 内 容 修 改 上 面 的 
脚本 程序 ,然后 再 次 执行 该 脚本 程序 ,执行 结果 如 图 7-3 所 示 。 

def testsun(self): 修改 为 不 等 于 selfa + self.b 之 和 的 任意 数字 


F 断言 两 数 之 和 的 站 时 是 否 是 # 
self. assertEqual (myclass, sum(self.a, self. b), [3] " test sum fail’) 


E 72 


测试 结果 中 只 出 现 了 一 个 点 (. ) ,但 出 现 了 一 个 “F”, 这 表示 mytest 类 中 只 有 一 个 测试 
方法 执行 通过 了 , 另 一 个 失败 了 ,因为 3 加 1 不 等 于 3, 所 以 断言 失败 了 。 

再 次 按 如 图 7-4 所 示 的 代码 修改 脚本 程序 ,修改 后 再 次 执行 该 脚本 ,测试 结果 如 图 7-5 
所 示 。 

因为 在 测试 方法 testsum( ) 函数 中 ,增加 了 一 行 "res = 3 / 0”, 由 于 除数 不 能 为 零 ,所 以 
程序 执行 到 这 行 代码 时 , 抛 出 ZeroDivisionError 异常 ,但 并 没有 捕获 该 异常 ,导致 脚本 执行 
中 断 。 


e? " ; 
2 - Selenium WebDriver 3.0.— & 3M ERE Sci fs 


C: \Python27\python. eze D: /PythonProject/test /run test. py 


age 
i 
E 


- 一 一 tearDomnClass 
(YF 表示 有 一 个 测试 用 例 执行 失败 


FAIL: testsum (. main .mytest) 





Traceback (most recent call last): 
File "D:/PvihonProiect/test/run test.pY', line 39, in testsum 


self. lass.sum(self.a, self.b), 3, "test sum fail') 
“失败 的 原因 ， 抛 出 了 异常 
Ran 2 tests in 0. 002s 
FAILED Gaire D 7 表示 一 个 用 例 失败 
图 7-3 





s 具体 的 测试 用 便 ， 一 定 要 以 test 开 头 
def testsun(self): " cies. 
go «e— ihmix (7 8 
# E ERI RSOREEI 
self.assertEqual(myclass.sum(self.a, self.b), 3, "test sum fail’) 


图 7-4 


C: VPython27 Wpython. exe D:/PythonProject/test/run_test. py 
一 一 setUpClass 

—setÜp 

—tearDom 

—setÜp 

—tearDom 

一 一 tearDomClass 


(CE 7) 一 出现 E， 表 示 有 一 个 测试 用 例 程序 本 身 有 异常 


ERROR: testsum (_ main .mytest) 


- oeur? 





Traceback (most recent call last): 
File "D:/PvthonProiect/test/run test.pv, line 38, in testsum 


res 三 
ivisionError: integer division or modulo by zer 


Ran 2 tests in 0.002s 
nuncio 9 ATUM 
E 75 
(2) 动态 方法 不 再 覆盖 run Test ) 方 法 ,而 是 直接 在 一 个 测试 类 中 编写 多 个 测试 方法 。 


mytest 类 继承 自 unittest. TestCase 类 ,同时 重 写 了 setUp() ,setUpClass O ,tearDown O , 
tearDownClass() 方 法 ,并 且 定 义 了 两 个 以 "test? 开 头 的 方法 (注意 必须 以 test 开头 ,中 间 可 
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以 插入 _、 字 母 等 字符 )。 当 然 也 可 以 同时 在 一 个 . py 文件 中 编写 多 个 自 定义 测试 类 ,这 些 自 
定义 测试 类 都 必须 继承 unittest. TestCase 类 。 


7.2.5 ”测试 集合 


在 自动 化 测试 的 执行 过 程 中 ,通常 会 有 批量 运行 多 个 测试 用 例 的 需求 ,此 需求 称 为 运行 
测试 集合 (Test Suite) 。 将 功能 相关 的 测试 用 例 组 合 到 一 起 称 为 一 个 测试 用 例 集 ,unittest 
框架 中 通过 TestSuite 类 来 组 装 所 有 的 测试 用 例 集 。 也 就 是 说 ,使 用 测试 集合 可 以 同时 执 
行 同一 . py 文件 中 的 多 个 测试 用 例 类 。 

加 载 测试 集合 步骤 如 下 。 

(1) TestLoader( 测 试用 例 加 载 器 ) 根 据 传人 的 参数 获取 相应 的 测试 用 例 的 测试 方法 。 

(2) 然后 makeSuite( 通 常 由 单元 测试 框架 调用 ,用 于 生产 test suite 对 象 的 实例 ) 把 所 
有 的 测试 用 例 组 装 成 test suite 集合 。 

(3) 最 后 将 testsuite 集合 传 给 test runner 执行 。 

实例 代码 : 

# encoding - utf - 8 

import random 

import unittest 





class TestSequenceFunctions(unittest. TestCase) : 
def setUp(self): 
self.seq = range(10) 


def tearDown(self): 
pass 


def test choice(self): 
# 从 序列 seq P BLUE — PU 
element = random. choice(self. seq) 
# JeuEBG PLC Wü Sz ET P nn 


self.assertTrue(element in self. seq) 


def test sample(self): 
# 验证 执行 的 语句 是 否 描 出 本 异常 
with self.assertRaises(ValueError): 
random. sample( self. seq, 20) 
for element in random. sample(self.seq, 5): 


self.assertTrue(element in self. seq) 


class TestDictValueFormatFunctions(unittest. TestCase) : 
def setUp(self): 
self.seq = range(10) 


def tearDown(self): 
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pass 


def test shuffle(self): 
* BBLITALIR seq 的 顺序 
randon. shuffle(self.seq) 
self. seq. sort() 
self. assertEqual( self. seq, range(10)) 
# IEUEHÍT ARHI H T TypeError 异常 
self.assertRaises(TypeError, random. shuffle, (1, 2, 3)) 


if name == ' main ': 
# RERE MWK, KRH (üt Br DI" test "开头 的 测试 方法 ,并 返回 一 个 测试 套件 
testCasel = unittest. TestLoader(). loadTestsFromTestCase(TestSequenceFunctions) 
testCase2 = unittest. TestLoader( ). loadTestsFromTestCase(TestDictValueFormatFunctions) 
5A BUS IRI CE EB 
Suite - unittest.TestSuite([testCasel, testCase2]) 
* HW verbosity = 2, n] AFTEN ih E EAM DAL ET ER 


unittest.TextTestRunner(verbosity = 2).run(suite) 
测试 结果 : 
C: MPython27 python. exe D: /PythonProject/test/a. py 
test choice ( main .TestSequenceFunctions) ... ok 


test sample ( main .TestSequenceFunctions) ... ok 
test shuffle ( main .TestDictValueFormatFunctions) ... ok 


Ran 3 tests in 0.000s 
OK 


代码 解释 : 

(D) TestLoader 类 : 测试 用 例 加 载 器 ,返回 一 个 测试 用 例 集合 。 

(2) loadTestsFromTestCase 类 : 根据 给 定 的 测试 类 ,获取 其 中 的 所 有 以 “test" 开 头 的 
测试 方法 ,并 返回 一 个 测试 集合 。 

(3) TestSuite 类: 组装 测 试用 例 的 实例 ,支持 添加 和 删除 用 例 , 最 后 将 传递 给 test 
runner 进行 测试 执行 。 

(4) TextTestRunner 类 : 测试 用 例 执 行 类 ,其 中 Text 表示 以 文本 形式 输出 测试 结果 。 

更 多 说 明 : 

(1) 设置 verbosity 和 0 的 数字 ,输出 结果 中 不 提示 执行 成 功 的 用 例 数 。 

(2) 设置 verbosity 一 1, 输 出 结果 中 仅 以 点 (. ) 表 示 执 行 成 功 的 用 例 数 。 

(3) WE. verbosityZ2 的 数字 ,可 以 输出 每 个 用 例 执 行 的 详细 信息 ,特别 是 在 大 批量 执 
行 测试 用 例 时 ,可 以 根据 这 些 信息 判断 哪些 用 例 执 行 失败 。 

(4) TestRunner. run( ) 方 法 会 返回 一 个 TestResult 实例 对 象 ,该 实例 对 象 里 存储 着 所 
有 测试 用 例 执行 过 程 的 详细 信息 ,有 需要 的 读者 可 以 使 用 Python 的 dir() 方 法 查看 ,这 里 不 
详细 介绍 。 
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7.2.6 按照 特 定 顺 序 执行 测试 用 例 


通过 TestSuite 类 可 以 改变 测试 用 例 执 行 顺序 。 在 介绍 按照 特定 顺序 执行 测试 用 例 之 
前 ,让 我 们 先 看 看 unittest 框架 在 使 用 unittest. main() 方 法 启动 单元 测试 时 ,测试 用 例 的 执 
行 顺序 。 

测试 代码 : 

在 PyCharm 工具 中 新 建 Python 工程 “Calc”, 在 该 工程 下 新 建 两 个 Python 文件 “Calc. 
py" fl^ MyTest. py”, 工 程 结构 如 图 7-6 所 示 o 

Python 文件 “Calc. py 详细 代码 如 下 : — m 

Elle Edit View Navigate Code Re 
# coding - ut£ - 8 Dao e^xmm: 
class Calc(object): D Cale ` [È MyTestpy ——— 0 


Y D Calc (pAPythonProjectiCalc) 
» O idea Python 工程 















def add(self, x, y, *d): 
# 加 法 计算 





result =x+y È Calc.py a— 
for i ind: li MyTest.py a— 
result += i 
return result 
图 7-6 


def sub(self, x, y, *d): 
# 减法 计算 
result = x - y 
for i ind: 
result -= i 
return result 


(à classmethod 
def nul(cls, x, y, *d): 
# 乘法 计算 
result - x * y 
foriind: 
result * = i 
return result 


(9 staticmethod 
def div(x, y, *d): 
# I 
ify! 0: 
result = x/ y 
else: 
return -1 
for iind: 
ifi 0: 
result /= i 
else: 
return -1 
return result 





Jia 
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Python 文件 “MyTest. py” 详 细 代 码 如 下 : 


# encoding= utf -8 
import unittest 
from Calc import Calc 


class MyTest(unittest. TestCase): 


(à classmethod 

def setUpClass(cls): 
print u" 单元 测试 前 ,创建 Calc 类 的 实例 ” 
cls.c = Calc() 


# 具体 的 测试 用 例 , 一 定 要 以 test 开头 
def test add(self): 
print "run add()" 
self.assertEqual(MyTest.c.add(1, 2, 12), 15, 'test add fail') 


def test sub(self): 
print "run sub()" 
self.assertEqual(MyTest.c.sub(2, 1, 3), -2, 'test sub fail') 


def test mul(self): 
print "run mul()" 
self.assertEqual(Calc.mul(2, 3, 5), 30, 'test mul fail') 


def test div(self): 
print "run div()" 
self.assertEqual(Calc.div(8, 2, 4), 1, 'test div fail') 


if name  -- 


unittest.main() # 启动 单元 测试 


cmd 下 执行 MyTest. py 文件 。 
测试 结果 : 


单元 测试 前 ,创建 Cale 类 的 实例 
run add() 


Ran 4 tests in 0.007s 


OK 


结果 说 明 : 
从 输出 结果 可 以 看 出 ,以 unittest. main() 这 种 方式 启动 的 单元 测试 ,各 测试 方法 的 执 
行 顺序 是 所 有 方法 名 的 字符 串 按照 ASCI 码 排 序 后 的 顺序 。 但 如 果 我 们 想 让 test_mul() 


a Too 
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这 个 测试 用 例 在 test_add() 方 法 之 前 执行 ,该 怎么 办 ? 修改 MyTest py 文件 中 如 图 7-7 所 


示 的 代码 如 下 : 
if name  — '' main ': 
if name  -- ' main ': unittest. main) # 启动 单元 测试 
# unittest. main() # 启动 单元 测试 
# HIR TestSuite 的 实例 对 和 象 图 7-7 


suite = unittest. TestSuite() 
KRAUS TL E C nh 
suite.addTest(MyTest("test mul")) 
suite.addTest(MyTest("test div")) 
suite.addTest(MyTest("test add")) 
suite.addTest(MyTest("test sub")) 
# 创建 TextTestRunner 2E [fj S: fr] x] R 
runner = unittest. TextTestRunner( ) 
runner. run(suite) 


再 次 执行 MyTest. py 文件 ,可 以 看 到 test_mul() 方 法 最 先 被 执行 ,结果 如 下 : 
单元 测试 前 ,创建 calc 类 的 实例 


run mul() 
.run div() 
.run add() 
.run sub() 


Ran 4 tests in 0.007s 


OK 
从 测试 结果 可 以 看 出 ,测试 用 例 已 经 按照 我 们 设 定 的 特定 顺序 进行 执行 。 
代码 解释 : 


首先 是 获得 一 个 单元 测试 中 用 例 集 TestSuite 的 实例 对 象 suite, 再 按照 我 们 设 定 的 顺 
序 将 相应 的 用 例 添加 到 集合 对 象 的 实例 中 ,然后 创建 一 个 用 单元 测试 中 的 TextTestRunner 
类 的 实例 对 象 runner, 最 后 将 集合 对 象 suite 添加 到 执行 对 象 实例 runner 中 ,并 调用 它 的 
run 方法 开始 执行 这 些 测 试用 例 。 

使 用 这 种 方法 ,我 们 就 可 以 添加 多 个 用 例 到 用 例 集中 ,组 成 一 组 用 例 , 然 后 再 按照 设 定 
的 顺序 去 执行 这 些 用 例 , 特 别 是 在 某 些 复杂 的 依赖 测试 场景 中 ,只 有 当 某 个 或 某 几 个 测试 用 
例 被 执行 后 才能 执行 其 他 的 测试 用 例 ,这 种 方法 给 我 们 提供 了 极 大 的 方便 ,比如 只 有 在 登录 
126 邮箱 后 ,才能 发 邮件 或 添加 新 联系 人 等 场景 。 但 这 种 方法 只 能 线性 执行 ,如 果 想 实现 并 
发 的 执行 用 例 , 读 者 可 以 自行 编写 多 线程 去 实现 。 

更 多 说 明 : 

在 MyTest 类 中 ,每 一 个 以 “test” 字 符 串 开头 的 方法 都 是 一 个 测试 用 例 , 具体 从 
TestLoader 类 加 载 测 试用 例 原 理 上 来 解释 。 在 unittest. TestLoader 类 (文件 路 径 为 
\Python27\Lib\unittest\loader. py) 中 有 一 个 loadTestsFromTestCase() 方 法 ,其 具体 代码 
如 下 : 


Pi = 


def loadTestsFromTestCase(self, testCaseClass): 

"""Return a suite of all tests cases contained in testCaseClass""" 

if issubclass(testCaseClass, suite.TestSuite): 
raise TypeError("Test cases should not be derived from TestSuite." V 

" Maybe you meant to derive from TestCase?" ) 

testCaseNames = self.getTestCaseNames(testCaseClass) 

if not testCaseNames and hasattr(testCaseClass, 'runTest'): 
testCaseNames - ['runTest'] 

loaded suite = self.suiteClass(map(testCaseClass, testCaseNames)) 

return loaded suite 


testCaseNames = self. get TestCaseNames (testCaseClass) 这 行 代码 中 的 get TestCaseNames C) 
(具体 代码 也 在 loader. py 文件 中 ) 方 法 是 从 testCaseClass 这 个 类 中 寻找 所 有 以 “test? 开 头 
的 方法 (所 以 ,不 以 “test" 开 头 的 方法 将 会 被 忽略 执行 ) ,然后 将 其 赋 给 testCaseNames 变量 。 
loaded suite = self. suiteClass( map (testCaseClass, testCaseNames)) 这 行 代码 用 于 创建 
TestSuite 类 对 象 , 其 中 使 用 Python 内 建 的 map 方法 ,为 testCaseNames 变量 中 每 一 个 元 素 
都 构建 testCaseClass 类 对 象 实例 ,最 后 使 用 suiteClass() 方 法 构造 成 一 个 TestSuite 对 象 集 
合并 赋 给 loaded suite 变量 ,如 下 代码 更 能 详细 说 明 其 过 程 : 

testCasesList = [] 

for caseName in testCaeNames : 

testCaseList. append(TestCase(caseName) ) 

loaded suite = self.suiteClass(tuple(testCasesList)) 

由 此 可 见 ,MyTest 类 中 每 一 个 以 "test? 开 头 的 方法 ,都 是 一 个 TestCase 对 象 ,也 就 是 
说 是 一 个 测试 用 例 。 


7.2.7 忽略 某 个 测试 方法 


在 批量 执行 测试 用 例 时 ,可 能 会 遇 到 某 些 测试 用 例 不 需要 执行 ,但 又 想 保留 测试 代码 ， 
除了 可 以 注释 掉 代 码 以 外 ,unittest 框架 提供 了 一 个 更 简便 的 注解 方法 用 来 忽略 那些 暂时 
不 需要 执行 的 测试 用 例 , 单 元 测试 框架 在 执行 过 程 中 遇 到 被 标 上 忽略 的 注解 的 用 例 时 ,就 会 
自动 跳 过 。 忽 略 测试 用 例 分 为 无 条 件 忽略 和 有 条 件 忽略 , 详 见 如 下 代码 介绍 。 

实例 代码 : 





# coding- utf -8 
import random 
import unittest 
import sys 


class TestSequenceFunctions(unittest. TestCase) : 
gcc 


def setUp(self): 
self.seq - list(range(10)) 


@unittest. skip(" skipping") # EK {FZ BE IX I 2A 
def test shuffle(self): 
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random. shuffle(self.seq) 

self.seq. sort() 

self. assertEqual(self. seq, list(range(10))) 
self.assertRaises(TypeError, random. shuffle, (1, 2, 3)) 


# 如 时 变量 a >5 则 名 有 属 该 测试 方法 
(Qunittest.skipIf(a »5, "condition is not satisfied!") 
def test choice(self): 
element = random. choice(self. seq) 
self.assertTrue(element in self.seq) 


* 秦 非 执行 测试 用 例 的 平台 是 Windows 平台 ,否则 名 履 该 测试 方法 
(Qunittest. skipUnless( sys. platform. startswith(" linux" ), "requires Windows") 
def test sample(self): 
with self.assertRaises(ValueError): 
random. sample( self. seq, 20) 
for element in random. sample( self. seq, 5): 
self.assertTrue(element in self. seq) 


if name  -- 
# unittest.main() 
testCases = unittest. TestLoader(). loadTestsFromTestCase(TestSequenceFunctions) 
suite - unittest. TestSuite(testCases) 
unittest. TextTestRunner(verbosity = 2).run(suite) 


执行 结果 : 
test choice ( main .TestSequenceFunctions) ... ok 
test sample ( main . TestSequenceFunctions) ... skipped 'requires Windows' 


test shuffle ( main .TestSequenceFunctions) ... skipped 'skipping" 


Ran 3 tests in 0. 006s 
OK (skipped - 2) 


结果 说 明 : 
从 测试 结果 可 以 分 析出 ,test_sample 和 test. shuffle 方法 被 忽略 执行 了 ,test_choice 方 
法 被 成 功 执行 了 ,skipped 王 2 表示 有 两 个 测试 方法 被 跳 过 执行 。 


7.2.8_ 命 令 行 模式 执行 测试 用 例 


unittest 框架 支持 命令 行 模式 运行 测试 模块 、 类 .甚至 单独 有 效 的 测试 方法 。 通 过 命令 
行 模式 ,可 以 传人 任何 模块 名 组 合 , 有 效 的 测试 类 或 者 测试 方法 的 参数 列表 。 详 细 使 用 方法 
参看 下 面 的 实例 (本 节 测 试 示 例 使 用 前 面 编写 的 Python 工程 Cale 实例 ) 。 

1. 通过 命令 直接 运行 整个 测试 模块 

命令 格式 : 


python 一 m unittest test modulel test module2 … 
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实战 步骤 : 
(D cmd 下 切换 当前 工作 目录 到 Python 工程 Cale 目录 下 ,如 图 7-8 所 示 。 








(2) cmd 下 执行 python -m unittest-vMyTest 命令 ,输出 结果 如 图 7-9 所 示 。 





2. 执行 测试 模块 中 某 个 测试 类 

命令 格式 : 

python 一 m unittest test module. TestClass 

实战 步骤 : 

cmd 下 将 当前 工作 目录 切换 到 Python 工程 Cale 目录 下 .然后 执行 命令 


命令 python 
果 如 图 7-10 所 示 






unittest -v MyTest. MyTest, 运 和 





图 7-10 


3. 执行 测试 模块 中 某 个 测试 类 下 的 某 个 测试 方法 
命令 格式 : 


python 一 m unittest test module. TestClass.test method 
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实战 步 又: 
cmd 下 将 当前 工作 目录 切换 到 Python 工程 Calc 目录 下 ,然后 执行 命令 python -m 
unittest -v MyTest. MyTest. test add MyTest. MyTest. test_sub ,运行 结果 如 图 7-11 所 示 。 


指 行 MyTest 模 块 下 MyTest 类 中 的 


test_add 和 test_sub 方 法 





更 多 说 明 : 

(1) 使 用 命令 执行 测试 用 例 前 ,必须 将 cmd 当前 的 工作 目录 切换 到 测试 脚本 文件 存放 
目录 ,如 果 想 直接 指定 脚本 文件 所 在 路 径 去 运行 ,会 抛 出 ImportError 异常 

(2) 这 种 命令 执行 方式 对 脚本 所 在 目录 名 以 及 测试 脚本 文件 名 都 没有 特殊 要 求 。 

G) 命令 中 -v 参数 表示 输出 测试 用 例 执行 的 详细 信息 ,等 价 于 verbosity = 2, 


7.2.9 批量 执行 测试 模块 


之 前 我 们 了 解 的 都 是 针对 同一 测试 模块 来 展开 的 测试 运行 ,本 节 介 绍 一 下 unittest 单 
测试 框架 提供 的 批量 执行 测试 模块 方法 ,官方 称 之 为 测试 发 现 。unittest 单元 测试 框架 

支持 简单 的 测试 发 现 , 即 可 以 自动 发 现 并 执行 给 定 目 录 下 满足 规则 的 测试 模块 。 为 了 更 好 
地 匹配 测试 模块 ,给 定 目录 下 所 有 的 测试 文件 都 必须 是 模块 或 者 是 能 从 工程 的 顶层 目录 导 
入 的 包 , 也 就 意味 着 所 有 的 文件 名 必须 是 有 效 的 标识 符 , 同 时 目录 下 需要 被 执行 的 测试 脚本 
文件 名 都 必须 以 "test?" 字 符 串 开头 ,比如 testEqual. py。 文 件 分 两 种 形式 : 程序 文件 模式 和 
命令 行 模式 。 

1. 程序 文件 模式 

程序 文件 模式 就 是 将 测试 发 现代 码 编写 在 测试 脚本 中 ,然后 直接 执行 脚本 文件 即 可 , 具 
体 由 TestLoader. discover() 方 法 实现 
实例 代码 : 
PyCharm 工具 中 新 建 一 名 叫 project_discover( 工 程 名 可 以 随便 取 ) 的 Python 工程 ,在 
该 工程 下 新 建 5 个 Python 文件 Calc. py,testCalc. py,testFact. py,testSeqSum. py,run. py: 
各 文件 详细 代码 如 下 

Calc. py( 供 其 他 模块 调用 ) 
























# coding- utf- 8 
class Calc(object): 


def add(self, x, y, *d): 
# 加 法 计算 
result = x + y 
for i ind: 
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result += i 
return result 


def mul(self, a, b): 
# 人 返回 两 数 之 积 


returna * b 


testCalc. py( 测 试 模块 ) 


# encoding- utf- 8 
import unittest 
from Calc import Calc 


class MyTest(unittest. TestCase): 
c = None 


(àclassmethod 

def setUpClass(cls): 
print u" 单 元 测试 前 ,创建 Calc 类 的 实例 " 
cls.c = Calc() 


# 具体 的 测试 用 例 , 一定 要 以 test 开头 
def test add(self): 
print "run add()" 
self.assertEqual(MyTest.c.add(1, 2, 12), 15, 'test add fail') 


testFact. py( 测 试 模块 ) 


# encoding = utf - 8 
import unittest 
from Calc import Calc 


class MyTestCase(unittest. TestCase) : 
def setUp(self): 
self.num = 5 


def testFactorial(self): 
# 生成 一 个 递增 序列 
seq = range(1, self.num + 1) 
# 3753 
res = reduce(lambda x, y: x * y, seq) 
zB EE 
self.assertEqual(res, 120, "断言 阶乘 结果 错误 !") 


testSeqSum. py (测试 模块 ) 


# encoding= utf -8 
import unittest 


class MyTestCase(unittest.TestCase): 
def testEqual(self): 
seq - range(11) 
self.assertEqual(sum(seq), 55," 断 言 列 表 元 素 之 和 结果 错误 !" ) 
run. py( 用 于 发 现 目录 下 的 测试 模块 并 执行 ) 


#coding= utf - 8 
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import unittest 


if nane  -- ' main - 
* nd idt Hox F BEBÉ SUI BUE, ". RU ii A R 
testSuite = unittest. TestLoader().discover('.') 
unittest. TextTestRunner(verbosity = 2).run(testSuite) 


—— 


注意 日 拥有 这 段 代码 的 Python 文件 ,必须 放 在 需要 被 执行 的 测试 脚本 所 在 目录 。 


HK 


进入 run. py 文件 中 ,将 鼠标 移 到 最 后 一 行 代码 的 run 方法 上 , 单 击 鼠标 右键 ,选择 





P Run'rum ”命令 运行 run. py 文件 
执行 结果 : 
单元 测试 前 ,创建 calc 类 和 
test add (testCalc.MyTest) ... ok 
run add( ) 
testFactorial (testFact.MyTestCase) ... ok 
testEqual(testSegSum.MyTestCase) ... ok 


Ran 3 tests in 0. 000s 
OK 


结果 说 明 : 

从 执行 结果 分 析 , 工 程 project_discover 下 test_add testFactorial 和 testEqual 模块 均 
被 执行 了 。 

2. 命令 行 模式 

命令 行 批量 执行 某 个 目录 下 的 测试 脚本 ,通过 unittest 单元 测试 框 提供 的 discover fy 

令 实现 。 

实战 步骤 : 

COD cmd 下 切换 当前 工作 目录 到 7. 2. 8 小 节 创建 的 Python 工程 project_discover A 


(2) cmd 下 执行 命令 python -m unittest discover ,执行 结 果 如 图 7-12 所 示 。 


ar 切换 当前 工作 目录 


NT 


批量 执行 目录 下 的 测 计 
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更 多 说 明 : 

CD 上 述 执 行 命令 的 顺序 不 能 更 改 。 

(2) 在 执行 批量 执行 测试 脚本 命令 前 ,必须 将 cmd 当前 的 工作 目录 切换 到 存放 测试 脚 
本 所 在 目录 。 

(3) discover 命令 还 有 一 些 其 他 参数 ,说明 如 下 : 

-v: 输出 详细 测试 信息 ,比如 python -m unittest discover -v. 

-s: 执行 发 现 测试 脚本 的 目录 ,默认 为 当前 目录 (. ), 比 如 python -m unittest discover 
-v -s D;\PythonProject\project_discover, 

-p: 模式 匹配 测试 文件 ,比如 python -m unittest discover -p "test *. py". 

-t directory: 工程 的 根 目录 下 搜索 可 执行 的 测试 脚本 ,默认 是 当前 目录 ,比如 python 
-m unittest discover -v -t D:\PythonProject\project_discover。 

(4). discover 命令 添加 -s -p、-t 参 数 时 ,由 于 可 以 人 为 指定 搜索 测试 脚本 目录 ,所 以 执 
行 测 试 脚 本 命令 也 等 价 于 下 面 两 条 命令 。 

python - m unittest discover - s project directory - p" * _test. py" 

python -m unittest discover project directory "* test.py" 


7.2.10 常用 的 断言 方法 


断言 表示 为 一 些 布尔 表达 式 , 编 写 代码 时 ,程序 员 总 是 会 在 某 些 特定 点 做 出 一 些 假设 ， 
来 判断 程序 是 否 达到 预期 。 断 言 为 真 时 ,表示 达到 预期 ,否则 未 达到 预期 。 而 对 于 自动 化 测 
试 人 员 来 说 ,借助 断言 能 更 好 地 检测 被 测试 对 象 是 否 满足 测试 期 望 。 

在 单元 测试 过 程 中 必须 使 用 断言 unittest 单元 测试 框架 中 的 TestCase 类 提供 了 很 多 
断言 方法 ,便于 检验 测试 是 否 满足 预期 结果 ,并 能 在 断言 失败 后 抛 出 失败 的 原因 。 本 节 只 介 
绍 其 中 一 部 分 常用 的 断言 方法 ,如 表 7-1 所 示 。 

表 7-1 TestCase 类 中 常用 断言 方法 



































断言 方法 检 W Python 版 本 
" 测试 first = = second, 否则 抛 出 断言 异常 信 
assertEqual(first, second, msg= None) 
息 msg 
assertNotEqual ( first, second. msg = | 测试 first! = second, 否则 抛 出 断言 异常 信 
None) 息 msg 
测试 表达 式 expr 为 True, 和 否则 抛 出 断言 异常 信 
assertTrueCexpr» msg — None) 
息 msg 
测试 表达 式 expr 为 False, 和 否则 抛 出 断言 异常 
assertFalse(expr, msg= None) 
信息 msg 
i] — 对 ,否则 F3.» 251 
assertls(a,b, msg= None) WARE HP RUN NI fS 27 
息 msg 
b — 33 ,否则 言 异常 
assertsNot(a,b, msg=None) WILSRUDA ERI EAR S RURIUE CER 2.7 
信息 msg 
on a 测试 表达 式 expr 结果 为 None, 否 则 抛 出 断言 Z 
assertIsNone(expr, msg= None k 
IM 异常 信息 msg 
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续 表 
断言 方法 检 测 Python 版 本 
assertsNotNone(expr, msg None) 测试 表达 式 expr ARR None, S GM hW 2.7 
言 异常 信息 msg 
b E b 中 , 否 出 断言 异常 信 
assertIn(a,b, msg— None) 测试 a 包含 在 b 中 ,否则 抛 出 断言 异常 信 23 
息 msg 
试 a 不 E ,否则 抛 出 断言 异常 信 
assertNotIn(a, b, msg— None) WESS ELSE D ICECM INBUNCEISSINUIS 2.7 
息 msg 
断言 obj 为 cls 类 型 ,否则 抛 出 断言 异常 信息 
assertlsInstance(obj, cls, msg= None) | msg。 可 以 用 isinstance(obj,cls) 或 者 rA 


assertIs( type(obj), cl) f& EE 





断言 obj 不 为 cls 类 型 ,否则 抛 出 断言 异常 信息 
msg。 可 以 用 not isinstance (obj, cls) 或 者 2.7 
assertIsSNot(type(obj) ，cls) 代 替 


assertNotIsInstance (obj, cls, msg = 


None) 





assertRaises ( exc [, fun, * args, * * | 测试 函数 fun( * args, ** kwds) 抛 出 exc 异 
kwds 常 ,否则 抛 出 断言 异常 





测试 函数 fun( * args，x* kwds) 抛 出 exc $ 
常 ,同时 可 用 正则 r 去 匹配 异常 信息 exc. 否则 2.7 
抛 出 断言 异常 


* 


assertRaisesRegexp C exc, r [, fun, 


args, ** kwds]) 








各 方法 的 实例 脚本 : 


# encoding = utf - 8 
import unittest 
import random 


# gx 
class MyClass(object): 
(à classmethod 
def sun(cls, a, b): 
returna * b 


(à classmethod 
def div(cls, a, b): 
return a / b 


@classmethod 
def retrun None(cls): 
return None 


# 单元 测试 类 


class MYTest(unittest. TestCase) : 


£ assertEqual() 方 法 实例 

def test assertEqual(self): 
# Bie RMR 
try: 
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sum - 13 

self.assertEqual(a + b, sum, 'BrEi XU, %s + %s!= %s' %(a, b, sun)) 
except AssertionError, e: 

print e 


# assertNotEqual( )7y if; S: fil 
def test assertNotEqual(self): 
E biaa 25M AUR. 
try: 
a,b-25,2 
res = 3 
self.assertNotEqual(a - b, res,' 断 言 失败 , %s - %s = %s' % (a, b, res)) 
except AssertionError, e: 
print e 


# assertTrue() Zr i S fs] 
def test assertTrue(self): 
# 肠 言 表达 式 为 真 
try: 
self.assertTrue(1 == 1," 表 达 式 为 假 ") 
except AssertionError, e: 
print e 


# assertFalse()J7r i; S: ffl 
def test assertFalse(self): 
# 断言 表达 式 为 恨 
try: 
self.assertFalse(3 == 2, "表达 式 为 真 " ) 
except AssertionError, e: 
print e 


£ assertIs() 方 法 实例 
def test assertIs(self): 
# 肠 谨 两 变量 类 型 属于 同一 对 象 
try: 
| 12 
b= a 
self.assertIs(a, b, "名 s 与 %s 不 属于 同一 对 象 ”% (a, b)) 
except AssertionError, e: 


print e 


# test assertIsNot() 方 法 实例 
def test assertIsNot(self): 
# biR AE EEG BET p] — 1 8 
try: 
a - 12 
b - "test" 
self. assertIsNot(a, b, "$%s 与 $s 属 于 同一 对 象 ” $ (a, b)) 
except AssertionError, e: 
print e 
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# assertIsNone() 方 法 实例 
def test assertIsNone(self): 
# MAKARRA None 
try: 
result - MyClass.retrun None() 
self.assertlIsNone(result, "not is None") 
except AssertionError, e: 
print e 


# assertIsNotNone() 方 法 实例 
def test assertIsNotNone( self): 
# 肠 言 表达 式 缚 扣 不 为 None 
try: 
result = MyClass. sum(2, 5) 
self. assertIsNotNone( result, "is None") 
except AssertionError, e: 
print e 


# assertIn() Zr i; 3c ø 
def test assertIn(self): 
* BIA SE STEXIHR BI 
try: 
strA = "this is a test" 
StrB = "is" 
self.assertIn(strB, strA, "名 s 不 包含 在 名 s 中 " #% (strB, strA)) 
except AssertionError, e: 
print e 


# assertNotIn() Jr i; S: ffl 
def test assertNotIn(self): 
# MER ATIS EXER BP 
try: 
strA = "this isa test" 
StrB - "Selenium" 
self.assertNotIn(strB, strA, "名 s 包 含 在 各 s 中 " % (strB, strA)) 
except AssertionError, e: 
printe 


# assertIsInstance( ) 7r ic; 3: ffl 
def test assertIsInstance(self): 
# 测试 对 象 A 的 类 型 是 否 是 指定 的 类 型 
try: 
x = MyClass 
y = object 
self.assertIsInstance(x, y, "$ s 的 类 型 不 是 %s"” & (x, y)) 
except AssertionError, e: 
print e 


# assertNotIsInstance() Jy 14; Sk [fi] 


def test assertNotIsInstance(self): 
# 测试 对 和 象 A 的 类 型 不 是 指定 的 类 型 
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a = 123 

b = str 

self. assertNotIsInstance(a, b, " %s 的 类 型 是 ss" %(a, b)) 
except AssertionError, e: 

print e 


# assertRaises() Zr i: Sc fa 
def test assertRaises(self): 
# EH HL E E I REDE 
# assertRaises(exception) 
with self.assertRaises(ValueError) as cm: 
random. sample([1,2,3,4,5], "3") 
# qmTÉU EAR E E ER 


print" ===", cm. exception 


# assertRaises(exception, callable, x args, * * kwds) 
try: 

self.assertRaises(ZeroDivisionError, MyClass.div, 3, 0) 
except ZeroDivisionError, e: 

print e 


# assertRaisesRegexp( ) 7j i4; 3i: fl 
def test assertRaisesRegexp(self): 
EON BO h HE GE POE DERI, TEILE VERE IS SCR fk o E 
# assertRaisesRegexp(exception, regexp) 
with self.assertRaisesRegexp(ValueError, 'literal') as ar: 
int("xyz" ) 
# 打印 详细 的 蜡 常 信息 
Print ar. exception 
# 打印 正则 囊 达 式 
print ar.expected regexp 


# assertRaisesRegexp(exception, regexp, callable, x args, * * kwds) 
try: 
self.assertRaisesRegexp(ValueError, 
"invalid literal for. * XYZ' $", int, 'XYZ') 


except AssertionError, e: 


print e 
if name  -- ' main ': 
# 热 行 单元 测试 


unittest.main() 


PyCharm 中 执行 该 脚本 程序 ,输出 结果 如 图 7-13 所 示 。 
从 PyCharm 的 Console 中 看 出 ,所 有 的 单元 测试 方法 都 成 功 执行 。 读 者 可 以 自行 修改 
断言 函数 中 的 参数 值 ,来 查看 不 同 的 断言 结果 。 
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C: VPython27 python. eze D: /PythonPro ject /test. py 
断言 失败 ，1 + 2 != 13 

断言 失败 , 5 - 2 != 3 

一 sample larger than population 

invalid literal for int() with base 10: "xyz' 
literal 


CE 一 所 有 的 测试 方法 都 成 功 执行 


agaes» 


ed 





Ran 14 tests in 0.000s 


ej 
Process finished with ezit code 0 


图 7-13 


更 多 说 明 

对 于 assertRaisesCexc. fun. * args. ** kwds),assertRaisesRegexp (exc, r, fun, 
x args, ** kwds) 断 言 异 常 的 函数 来 说 ,如 果 只 给 出 异常 类 型 参数 exc, 将 返回 一 个 上 下 文 
管理 器 ,以 便 测试 的 代码 可 以 直接 内 联 而 不 是 写 入 函数 中 。 上 下 文 管理 器 将 在 其 异常 属性 
中 存储 被 捕获 的 异常 对 象 。 如 果 意 图 是 在 引发 的 异常 上 执行 额外 的 检查 ,这 些 信息 就 非常 
有 用 了 。 这 是 Python 2. 7 版 本 新 增加 的 功能 。 


7.2.11 使 用 HTMLTestRunner 生成 HTML 测试 报告 





单元 测试 结束 后 ,可 以 通过 HTMLTestRunner 生成 HTML 测试 报告 。 之 前 我 们 执行 
的 测试 结果 都 是 输出 到 控制 台 , 既 不 方便 阅读 ,也 不 美观 ,使 用 HTML TestRunner 模块 就 
可 以 将 测试 结果 以 HTML 页 面 的 形式 展现 出 来 。 

使 用 前 期 准备 : 

(D 下 载 HTMLTestRunner. py 文件 ,下 载 地 址 : 

http://tungwaiyip. info/software/ HTML TestRunner, html, 

(2) 将 HTMLTestRunner. py 文件 复制 至 Python 安装 路 径 下 的 lib 文件 夹 中 。 

(3) 进入 Python 文件 或 者 Python 交互 模式 下 ,执行 import HTMLTestRunner, 如 果 
没有 报错 ,说 明 配 置 成 功 。 

实例 代码 : 

# coding- utf - 8 

import unittest 

import HTMLTestRunner 

import math 


class Calc(object): 


def add(self, x, y, *d): 
# 加 法 计算 
result - x * y 
for i ind: 
result += i 
return result 
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def sub(self, x, y, *d): 
# 诚 法 计算 
result = x - y 
foriind: 
result -= i 
return result 


class SuiteTestCalc(unittest. TestCase): 
def setUp(self): 
self.c - Calc() 


@unittest. skip(" skipping") 
def test Sub(self): 
print "sub" 
self.assertEqual(self.c. sub(100, 34, 6), 60, GR EAS «REIR! ') 


def testAdd(self): 
print "add" 
self.assertEqual(self.c.add(1, 32, 56), 89,' 求 和 结果 错误 ! ') 


class SuiteTestPow(unittest. TestCase): 
def setUp(self): 
self. seq = range(10) 


# @unittest. skipIf() 
def test Pow(self): 
print "Pow" 
self.assertEqual(pow(6, 3), 216, GRE & SER! ') 


def test hasattr(self): 
print "hasattr" 
# 检 测 math BER E S ff fe pow [TE 
self.assertTrue(hasattr(math, 'pow'), "检测 的 属性 不 存在 !") 


if nane == " main ": 


suitel = unittest. TestLoader(). loadTestsFronTestCase(SuiteTestCalc) 
suite2 = unittest. TestLoader( ). loadTestsFromTestCase(SuiteTestPow) 
suite = unittest. TestSuite([suitel, suite2]) 
# unittest. TextTestRunner(verbosity- 2). run(suite) 
filename = "d: WW test. htn]" # 定义 报告 存 放 路 径 , EEMI RE GG 
# DUET T HT X EL ERES 
fp -file(filename, 'wb') 
# (EH HIMLTestRunner MAB, fi ih IRE BELTS IRERE LEER, H9 PT A E 
runner = HTMLTestRunner.HTMLTestRunner(stream = fp, 
title= 'Report title', description = 'Report description') 
# 和 运行 测试 集 合 


runner.run(suite) 


PyCharm 工具 执行 该 测试 代码 ,执行 成 功 后 在 D 盘 能 看 到 生成 的 test. html 文件 ,将 该 
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HTML 文件 拖 搜 到 浏览 器 中 ,可 看 到 如 图 7-14. 所 示 的 信息 。 


Report title-— js=u 





Start Time: 2016-10-19 17:59:54 
Duration: 0:00:00 
Status: Pass 3 





Report description * 报告 译 


Show Summary Failed All 


Test Group/Test case Error 





Total 3 3 0 0 





7.3 在 unittest 中 运行 第 一 个 WebDriver 测试 用 例 





本 节 将 在 unittest 单元 测试 框架 中 实现 第 一 个 WebDriver 测试 用 例 , 其 具体 实现 步 又 
如 下 。 

(1) 在 PyCharm 工具 中 新 建 一 个 Python 工程 UnitTestProj。 

(2) f£ UnitTestProj 工程 下 新 建 一 个 Python 文件 "gloryroad. py" ,并 在 该 文件 中 编写 
如 下 代码 : 


#encoding= utf -8 
import unittest 
from selenium import webdriver 


import time 


class GloryRoad(unittest. TestCase): 
def setUp(self): 
# Fi sl Firefox W I de 


self.driver = webdriver.Firefox(executable path = "c: Wgeckodriver") 


def testSoGou(self): 
# 访 问 搜 狗 首页 
self.driver.get("http: //sogou. con" ) 
H ER a A HERU N E 
self.driver.find element by id("query").clear() 
# 在 搜索 给 人 礁 中 给 人 " 光 迷 之 路 自动 化 测试 ” 
self.driver.find element by id("query"). send keys(u"WebDriver 实战 宝典 " ) 
zB di "HU 
self.driver.find element by id("stb").click() 
ETIER3E 
time. sleep(3) 
assert u" X RfE" in self.driver.page source, "页 面 中 不 存在 要 寻找 的 关键 字 !" 


def tearDown( self): 


BH UL dE 
self.driver.quit() 
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if nane  -- ' main ': 


unittest.main() 


(3) 在 mainO 〇 函数 上 单 击 鼠 标 右键 ,选择 PRun'gloyroad 命令 开始 执行 测试 用 例 , 待 所 
有 操作 步骤 都 完成 后 ,浏览 器 就 会 自动 退出 ,同时 在 PyCharm 结果 输出 区 域 也 可 以 看 到 
例 执 行 结果 信息 。 

注意 , WebDriver 启动 浏览 器 过 程 可 能 会 比较 慢 , 请 耐心 等 待 一 会 儿 。 
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Selenium WebDriver 根据 网 页 中 页 面 元 素 拥有 不 同 的 标签 名 和 属性 值 等 特征 来 定位 
不 同 的 页 面 元 素 , 并 完成 对 已 定位 到 的 页 面 元 素 的 各 种 操作 。 

在 自动 化 测试 实施 过 程 中 ,测试 脚本 中 常用 的 页 面 元 素 操作 步骤 如 下 : 

(1) 定位 网 页 上 的 页 面 元 素 , 并 获得 该 页 面 元 素 对 象 。 

(2) 通过 获取 的 页 面 元 素 对 象 拥有 的 属性 操作 该 页 面 元 素 。 例 如 , 单 击 . 拖 搜 页 面 元 素 
或 在 输入 框 中 输入 内 容 等 。 

(3) 设 定 页 面 元 素 的 操作 值 。 例 如 , 设 定 输入 框 中 输入 的 内 容 或 指定 下 拉 选 项 框 中 哪 
个 选项 等 。 

通过 以 上 三 步 ,可 以 完成 对 页 面 元 素 的 自动 化 操作 ,但 在 此 之 前 必须 要 获取 到 要 操作 的 
页 面 元 素 对 象 , 否 则 接 下 来 的 两 步 将 是 空谈 。 由 于 网 页 技术 的 实现 过 于 复杂 ,在 自动 化 测试 
实践 过 程 中 ,经 常 出 现 各 种 页 面 元 素 难 以 定位 的 难题 ,常常 有 人 绞 尽 脑汁 也 无 法 成 功 完成 某 
些 页 面 元 素 的 定位 。 为 了 更 好 地 解决 页 面 元 素 的 定位 难题 ,本 章 将 根据 笔者 多 年 的 最 佳 实 
践 经 验 ,详细 地 介绍 定位 页 面 元 素 的 常用 方法 。 





定位 页 面 元 素 方法 汇总 





在 低 版 本 的 Selenium. WebDriver 中 ,通常 使 用 find element 和 find elements 方法 ,再 
结合 By 类 来 实现 定位 页 面 元 素 , 但 在 高 版 本 的 Selenium WebDriver 官方 文档 中 ,已 经 开始 
建议 使 用 find_element_by_* 和 find elements by. * 方法 代替 前 两 种 方法 。WebDriver 对 
象 内 置 的 find element by. * 方法 仅 用 于 定位 单个 页 面 元 素 ,find_elements_by_* 方法 可 
用 于 同时 定位 多 个 页 面 元 素 , 以 列表 形式 返回 所 有 定位 到 的 页 面 元 素 。 定 位 到 的 页 面 元 素 
需要 进行 存储 ,以 便 在 以 后 的 测试 过 程 中 能 随时 取 用 。 

WebDriver 提供 了 8 种 不 同 的 定位 方法 ,分 别 为 id .name、xpath class name,tag name, 
link text, partial link text 以 及 css selector, 其 详细 使 用 方法 如 表 8-1 所 示 。 


表 8-1 





定位 方法 的 Python 语言 实现 实例 
定位 单个 元 素 定位 多 个 元 素 
find element by id("ID ffi) 
使 用 ID 定位 find element(by = "id". value = "ID | 因为 ID 唯一 ,所 以 不 能 定位 多 个 
值 ") 


定位 方法 
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续 表 
定位 方法 的 Python 语言 实现 实例 
定位 方法 
定位 单个 元 素 定位 多 个 元 素 
find_element_by_name("name 值 ") find_elements_by_name("name 值 ") 
使 用 name 定 位 | find_element(by = "name". value = | find. elements (by = " name", value = 
"name 值 ") "name 值 ") 
find_element_by_class_name(" 页 面 元 素 | find_elements_by_class_name(" 页 面 元素 
使 用 class name | 的 Class 属性 值 ") 的 Class 属性 值 ") 
定位 find_element(by = "class name", value = | find_elements(by = "class name", value = 
"页 面 元 素 的 Class 属性 值 ") "页 面 元 素 的 Class 属性 值 ") 
find element by tag name(" Jt ii "P ff | find_elements_by_tag_name(" 页 面 中 的 
使 用 标签 名 称 | HTML 标签 名 称 ") HTML 标签 名 称 ") 
定位 find element(by = "tag name". value = | find clements(by = "tag name", value = 
"页 面 中 的 HTML 标签 名 称 ") "页 面 中 的 HTML 标签 名 称 ") 
find_element_by_link_text(" 链 接 的 全 部 | find_elements_by_link_text(" 链 接 的 全 部 
使 用 链接 的 全 部 | 文字 内 容 ") 文字 内 容 ") 
文字 定位 find_element(by = "link text". value = | find_elements(by = "link text". value = 
"链接 的 全 部 文字 内 容 ") "链接 的 全 部 文字 内 容 ") 
find_element_by_partial_link_text(" 链 | find_elements_by_partial_link_text(" 链 接 
使 用 部 分 链接 文 | 接 的 部 分 文字 内 容 的 部 分 文字 内 容 ") 
字 定 位 find element(by = "partial link text". | find. elements (by = " partial link text", 
value 一 “链接 的 部 分 文字 内 容 ”) value 一 “链接 的 部 分 文字 内 容 ") 
本 et xpath" XPath ÆA | find dements-by-xpath( Kah EERE 
使 用 XPath 定位 BR A 
find element(by = "xpath", value — | find. elements (by = "xpath", value — 
"XPath 定位 表达 式 ") "XPath 定位 表达 式 ") 
find_element_by_css_selector("CSS 定 | find_elements_by_css_selector("CSS 定位 
使 用 CSS 方式 | 位 表达 式 ") 表达 式 ") 
定位 lind. lonmentitiby lind: dancüte(by- «cos ndlectiris: value 











二 "CSS 定 位 表达 式 ") 


使 用 ID 定 亿 


被 测试 网 页 的 HTML 代码 : 


value = "CSS 定位 


<html> 
<body> 
< label > 用 户 名 </label > 
< input id= "username"></input > 
< label > 密码 </label > 
< input id= "password"></input> 
<br> 
<button id = "submit"> 登 录 </button > 
</body> 
</html > 
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生成 可 见 网 页 的 方法 : 在 硬盘 某 路 径 下 新 建 一 个 扩展 名 为 html 的 文件 ,将 上 面 代码 复 
制 至 该 文件 并 保存 ,然后 将 该 文件 直接 拖 搜 到 浏览 器 中 ,就 可 以 看 到 生成 的 HTML 页 面 。 





定位 语句 代码 : 

password = driver.find element by id("password") 

username - driver.find element(by - "id", value - "username") 
代码 解释 : 


由 于 页 面 元 素 的 ID 属性 都 是 唯一 的 ,所 以 不 存在 根据 ID 属性 值 同 时 定位 多 个 页 面 元 
素 的 情况 ,因此 上 面 只 给 出 了 两 种 定位 页 面 元 素 的 方法 。 语句 1 使 用 driver 对 象 的 find_ 
element_by_id 方法 通过 元 素 ID 属性 进行 页 面 元 素 定位 ,所 传 的 参数 值 *“password” 为 将 要 
被 定位 的 页 面 元 素 的 ID 属性 值 ,查看 被 测试 网 页 的 HTML 代码 可 以 找到 密码 输入 框 元 素 
的 ID 属性 值 为 “password”。 

同 理 ,语句 2 用 "username” 作 为 ID 属性 值 ,此 时 的 定位 方式 是 通过 参数 by 传人。 

由 于 页 面 元 素 的 ID 属性 都 是 唯一 的 ,所 以 使 用 ID 值 定位 页 面 元 素 可 以 保证 定位 的 唯 
一 性 ,不 会 像 其 他 定位 方式 可 能 会 同时 定位 到 多 个 页 面 元 素 。 但 在 自动 化 测试 实施 过 程 中 ， 
很 多 核心 页 面 元 素 均 无 ID 属性 值 , 导 致 无 法 使 用 ID 值 进 行 定位 操作 。 









可 与 Web 开发 工程 师 约 定 , 所 有 核心 页 面 元 素 都 添加 ID 属性 ,以 提高 网 页 
程序 的 可 测试 性 ,降低 自动 化 测试 的 实施 难度 ,提升 效率 。 


8.3 KJ 


被 测试 网 页 的 HTML 代码 : 


< html > 
<body> 
< label > 用 户 名 </label > 
< input name = "username"></input > 
< label > 密码 </label > 
< input name = "password"></input > 
<br> 
<button name = "submit"> 登 录 </button > 
</body> 
«/htnl > 


定位 语句 代码 : 





username = driver.find element by name("username") 

password = driver.find element(by = "name", value = "password") 

pwdList 

butList 

代码 解释 : 

语句 1 和 语句 2 均 是 用 于 定位 单个 页 面 元素 , 均 通过 name 定位 方式 进行 定位 ,定位 需 
要 的 name 值 均 通过 参数 传人 ,比如 “username” 和 “password”, 它 对 应 于 被 测试 HTMI 代码 


driver.find elements by nane("password") 
driver.find elements(by = "name", value = "submit") 
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中 用 户 名 输入 框 和 密码 输入 框 页 面 元 素 的 name 属性 值 。 

语句 3 和 语句 4 均 通 过 name 定位 方式 同时 定位 页 面 上 拥有 相同 name 属性 值 (比如 
name-— "password" 2k name= "submit" ) 的 所 有 页 面 元 素 , 每 个 定位 到 的 页 面 元 素 都 将 作为 
列表 的 一 个 元 素 ,然后 返回 这 个 列表 给 调用 者 。 

更 多 说 明 : 

页 面 元 素 的 name 属性 和 ID 属性 有 所 区 别 ,name 属性 值 在 当前 网 页 可 以 不 唯一 ,因而 
使 用 单个 页 面 元 素 定位 方法 时 通过 name 方式 定位 时 可 能 会 定位 到 多 个 元 素 , 此 时 需要 进 
一 步 定 位 以 保证 操作 元 素 

















8.4 使 用 链接 的 全 部 文字 定位 





被 测试 网 页 的 HTML 代码 : 


<html > 
<body> 
<a href = "http: //www. sogou. com"> sogou 搜索 </a><br> 
«a href = "http: //www. baidu. con"» baidu 搜索 </a> 
</body> 
</html> 


定位 语句 : 

link = driver.find element by link text("sogou 搜索 ") 

link = driver.find element(by = "link text", value = "sogou 搜索 ") 

linkList = driver.find elements by link text("baidu 搜索 ") 

linkList = driver.find elements(by = "link text", value = "baidu 搜索 ") 

代码 解释 : 

以 上 语句 都 通过 link text 定位 方式 进行 定位 。 定 位 需要 的 链接 文字 均 通 过 参数 传人 ， 
比如 “sogou 搜索 ”, 它 对 应 于 被 测试 HTMI 代码 中 超 链接 标签 的 文本 内 容 ,链接 文字 需要 完 
全 匹配 “sogou R” R “baidu 搜索 "这 几 个 关键 字 , 和 否则 将 无 法 找到 链接 页 面 元 素 。 

更 多 说 明 : 

使 用 此 方式 定位 页 面 链接 元 素 ,需要 完全 匹配 链接 标签 中 的 文本 内 容 , 常 用 于 页 面 中 存 
在 多 个 链接 文字 高 度 相似 , 且 无 法 使 用 部 分 链接 文字 进行 定位 的 情况 。 


8.5 EJEDES 


被 测试 网 页 的 HTML 代码 : 


<html> 
< body> 
<a href = "http: //www. sogou. com"> sogou 搜索 </a><br> 
<a href = "http: //www. baidu. com"> baidu 搜索 </a> 
</body> 
</html> 
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定位 语句 : 

partialLink = driver.find element by partial link text("sogou") 

partialLink = driver.find element(by = "partial link text", value = "sogou") 

partialLinkList = driver.find elements by partial link text(" 搜 索 ") 

partialLinkList = driver.find elements(by = "partial link text", value = "搜索 ") 

代码 解释 : 

语句 1 和 语句 2 都 使 用 partial link text 方 式 查找 包 仿 “sogou” 关键 字符 串 的 链接 元 素 。 
车 匹配 到 了 多 个 包含 “sogou” 关 键 字符 串 的 链接 元 素 ,将 返回 第 一 个 匹配 到 的 页 面 元 素 对 
象 , 并 将 其 赋值 给 partialLink 变量 。 

语句 3 和 语句 4 将 匹配 页 面 中 所 有 包含 “搜索 ”两 关键 字 的 超 链接 页 面 元 素 ,在 被 测试 
网 页 的 HTML 代码 中 可 看 到 有 两 个 包含 “搜索 "关键 字 的 链接 元 素 , 这 两 个 链接 元 素 都 会 
被 抓 取 到 ,并 存 于 列表 中 ,然后 将 该 列表 对 象 赋值 给 partialLinkList 变量 。 

更 多 说 明 : 

使 用 此 方式 定位 页 面 链接 只 需要 模糊 匹配 链接 文字 即 可 ,常用 于 匹配 页 面 链接 文字 不 
定期 发 生 少 量变 化 的 情况 。 使 用 模糊 匹配 的 方式 可 以 提高 链接 定位 的 准确 率 , 也 可 以 用 于 
模糊 匹配 一 组 链接 的 情况 。 


8.6 KISS oia 


被 测试 网 页 的 HTML 代码 : 


<html> 
< body> 
关键 字 : «input id = "keyword"></input ><br /> 
<a href = "http: //www. sogou. com"> sogou 搜索 </a> 
«a href = "http://www. baidu. com"> baidu 搜索 </a> 





</body> 
</html > 
定位 语句 : 
input = driver.find element by tag name("input") 
input = driver.find element(by = "tag name", value = "input") 
aList - driver.find elements by tag name("a") 


aList = driver.find elements(by = "tag name", value = "a") 


代码 解释 : 

语句 1 和 语句 2 使 用 tag name 方式 定位 页 面 中 HTML 标签 名 为 "input 的 页 面 元 素 ， 
并 将 查找 到 的 页 面 对 象 赋值 给 input 变量 。 

语句 3 和 语句 4 将 定位 页 面 中 所 有 HTML 标签 名 为 “a” 的 页 面 元 素 , 在 被 测试 网 页 的 
HTML 代码 中 可 看 到 有 两 个 HTML 标签 名 为 “a” 的 页 面 元 素 , 这 两 个 链接 元 素 都 会 被 定位 
到 ,并 存 于 列表 中 ,然后 将 该 列表 对 象 赋值 给 aList 变量 。 

更 多 说 明 : 

HTML 标签 名 称 的 定位 方式 主要 用 于 匹配 多 个 页 面 元 素 的 情况 .将 查找 到 的 网 页 元 素 
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对 象 进行 计数 、 遍 历 ,修改 属性 等 操作 。 


8.7 WES RORE- 


被 测试 网 页 的 HTML RE : 


<html> 
<head> 
<style type = "text/css"> 
input. spread ( FONT - SIZE: 20pt;) 
input. tight ( FONT- SIZE: 10pt;] 
</style> 
</head> 
<body> 
< input class = "spread" type = text ></input > 
< input class = "tight" type= text ></input > 
</body> 
</htm] > 


定位 语句 : 


spread = driver.find element by class name("spread") 

spread = driver.find element(by = "class name", value = "spread") 
tightList = driver.find elements by class name("tight") 

tightList = driver.find elements(by = "class name", value = "tight") 
代码 解释 : 


查看 被 测试 网 页 的 HTML 代码 ,可 以 看 到 两 个 输入 框 均 有 class 属性 , spread 类 定义 
的 字体 比 tight 类 大 10pt。 上 面 4 条 语句 都 是 使 用 class 属性 名 称 来 查找 页 面 元 素 的 。 

更 多 说 明 : 

可 以 根据 class 属性 值 来 查找 一 个 或 者 一 组 显示 效果 相同 的 页 面 元 素 。 


8.8 KE clu A 


XPath 定位 方式 是 自动 化 测试 定位 技术 中 的 必 杀 技 , 几 乎 可 以 解决 所 有 的 定位 难题 ,就 
算 HTML 标签 没有 id, name 等 属性 ,使 用 XPath 也 能 轻松 解决 这 些 页 面 元 素 定位 问题 。 
强烈 建议 读者 深入 掌握 该 定位 方式 的 详细 使 用 方法 。 


8.8.1 XPath 的 定义 


XPath 是 XML Path 语言 的 缩写 ,是 一 门 在 XML 文档 中 查找 信息 的 语言 , 它 在 XML 
文档 中 通过 元 素 和 属性 进行 导航 ,主要 用 于 在 XML 文档 中 选择 节点 。 基 于 XML 树 状 文档 
结构 ,XPath 语言 可 以 用 于 在 整 棵 树 中 沿 着 路 径 或 step( 步 ) 来 寻找 指定 的 节点 。XPath 定 
位 和 即将 讲 到 的 CSS 定位 相 比 具备 更 大 的 灵活 性 ,在 XML 文档 树 中 的 某 个 节点 既 可 以 向 
前 搜索 ,也 可 以 向 后 搜索 ,而 CSS 定位 只 能 在 XML 文档 树 中 向 前 搜索 ,但 XPath 的 定位 速 
度 比 CSS 稍 慢 。 
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XPath 使 用 路 径 表达 式 来 选取 XML 文档 中 的 节点 或 节点 集 。 节 点 是 通过 沿 着 路 径 
(path) 或 者 步 (step) 来 选取 的 。 


8.8.2 XPath 节点 


XPath 语言 中 提供 了 7 种 节点 : 文档 节点 ( 根 节点 )、 元 素 、 属 性 文本、 命名 空间 、 处 理 
指令 以 及 注释 。XML 文档 被 作为 节点 树 对 待 , 树 的 根 被 称 作 文档 节点 或 根 节点 。 
1. 节点 
XML 实例 文档 : 
<?xml version - "1.0" encoding- "utf - 8" ?> 
<! -一 这 是 一 个 注释 节点 -一 > 
<booklist type = "science and engineering" 
€ book category = "Selenium"> 
«title» WebDriver 实战 宝典 </title> 
<author > 吴 晓 华 </author > 
< pageNumber > 400 </pageNumber > 


</book> 
</booklist > 


在 上 面 的 XML 文档 实例 中 展示 的 节点 如 下 : 


<booklist >: 文档 节点 
<title>: 元 素 节点 
type = "science and engineering": 属性 节点 


2. 节点 间 的 关系 

(1) 父 节点 (Parent) 

每 个 元 素 以 及 属性 都 有 一 个 父 节点 。 上 面 的 XML 文档 实例 中 ,book 元 素 是 title, 
author 以 及 pageNumber 元 素 的 父 节点 。 

(2) 子 节点 (Children) 

一 个 元 素 节 点 可 有 零 个 ,一 个 或 多 个 子 节点 。 上 面 的 XML 文档 实例 中 ,title、author 以 
及 pageNumber 元 素 是 book 元 素 的 子 节点 。 

(3) 同胞 节点 (Sibling) 

同胞 节点 表示 拥有 相同 父 节点 的 节点 。 上 面 的 XML 文档 实例 中 ,title、author 以 及 
pageNumber 元 素 都 是 同胞 节点 。 

(4) 先辈 节点 (Ancestor) 

先辈 节点 表示 的 是 某 节 点 的 父 节 点 , 父 节 点 的 父 节 点 ,以 及 父 节点 的 所 有 祖先 节点 。 上 
面 的 XML 文档 实例 中 ,title 元 素 的 先辈 节点 有 book 和 booklist, 

(5) 后 代 节 点 (Descendant) 

后 代 节 点 表示 某 个 节点 的 子 节点 , 子 节点 的 子 节点 ,以 及 子 节点 的 所 有 后 代 节 点 。 上 面 
的 XML 文档 实例 中 .booklist 元 素 的 后 代 节 点 有 book, title, author 以 及 pageNumber 
元 素 。 
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8.8.3 XPath 定位 语法 


由 于 用 于 Web 开发 的 HTML 语言 的 语法 结构 跟 XML 很 相似 ,所 以 XPath 也 支持 在 
HTML 代码 中 定位 HTML 树 状 文档 结构 中 的 节点 。 后 续 小 节 均 使 用 HTML 代码 实例 来 
支持 对 XPath 语法 的 讲解 。 

被 测试 网 页 的 HTML 代码 : 








<html> 
< body » 
<div id= "divl" style = "text - align:center"» 
< ing alt = "divl- imgl" 
src = "http://www. sogou. com/images/1ogo/new/sogou. png" 
href = "http://www. sogou. com"> 搜 狗 图 片 </img>< br /> 
< input name = "divlinput"» 
<a href = "http://www. sogou. com"> 搜 狗 搜 索 </a> 
< input type = "button" value = "查询 "> 
</div> 
<br> 
<div name = "div2" style= "text - align:center"> 
< img alt = "div2- img2" src = "http://www. baidu. com/ ing/bdlogo. png" 
href = "http://www. baidu. com"> 百 度 图 片 </img>< br /> 
< input name = "div2input"> 
<a href = "http://www. baidu. com"> 百 度 搜索 </a> 
</div> 
</body> 
</html > 


使 用 上 面 HTML 代码 生成 被 测试 网 页 ,基于 此 网 页 来 实践 各 种 不 同 的 页 面 元 素 的 
XPath 定位 方法 。 

1. 使 用 绝对 路 径 来 定位 元 素 

绝对 路 径 表 示 页 面 元 素 在 被 测 网 页 的 HTML 代码 结构 中 ,从 根 节点 一 层 层 地 搜索 到 
需要 被 定位 的 页 面 元 素 ,绝对 路 径 起 始 于 正 斜 杠 (/) ,每 一 步 均 被 斜 杠 分 割 。 


目 的 : 

在 被 测试 网 页 中 ,查找 第 一 个 div 标签 下 的 “查询 ”按钮 。 

XPath 定位 表达 式 : 

/htnl/body/div/input[(2 value = "查询"] 

Python 定位 语句 : 

query = driver. find element by xpath('/html/body/div/input[@value= "查询 "]') 

代码 解释 : 

上 述 XPath 定位 表达 式 从 HTML DOM 树 的 根 节点 (html 节点 ) 开 始 逐 层 查找 ,最 后 
定位 到 “查询 ”按钮 节点 。 路 径 表 达 式 “/” 表 示 根 节点 。 

更 多 说 明 : 


使 用 绝对 路 径 定 位 页 面 元 素 的 好 处 在 于 可 以 验证 页 面 是 否 发 生变 化 。 如 果 页 面 结 构 发 


. 96- 


第 8 章 页 面 元 素 定位 方法 © 


生变 化 ,可 能 会 造成 原先 有 效 的 XPath 表达 式 失效 。 使 用 绝对 路 径 定位 是 十 分 脆弱 的 , 因 
为 即便 页 面 代码 结构 只 发 生 了 微小 的 变化 ,也 可 能 会 造成 原先 有 效 的 XPath 定位 表达 式 定 
位 失败 。 因 此 ,建议 在 自动 化 测试 的 定位 实施 环节 中 ,优先 考虑 使 用 后 面 将 要 介绍 的 相对 路 
径 进 行 页 面 元 素 的 定位 。 

后 续 无 特殊 要 求 ,定位 元 素 的 方法 默认 均 使 用 find. element. by_* 或 find elements by * 。 

2. 使 用 相对 路 径 定位 元 素 

相对 路 径 的 每 一 步 都 根据 当前 节点 集 之 中 的 节点 来 进行 计算 ,起 始 于 双 正 斜 杠 (//)。 

目的 : 

在 被 测试 网 页 中 ,查找 第 一 个 div 标签 下 的 “查询 ”按钮 。 

XPath 定位 表达 式 : 


//input[@value= "查询 "] 
Python 定位 语句 : 
query = driver. find element by xpath('//input[@value= "查询 "]') 


代码 解释 : 

E XPath 定位 表达 式 中 的 “//" 表 示 从 匹配 选择 的 当前 节点 开始 选择 文档 中 的 节点 ， 
而 不 考虑 它们 的 位 置 。input[@value 二 "查询 "表示 定 位 value 值 为 “查询 ”两 个 字 的 input 
页 面 元 素 。 

更 多 说 明 : 

相对 路 径 的 XPath 定位 表达 式 更 加 简洁 ,不 管 页 面 发 生 了 何 种 变化 ,只 要 input 标签 的 
value 属性 值 没 变 , 始 终 都 可 以 定位 到 。 推 荐 使 用 相对 路 径 的 XPath 表达 式 , 并 且 越 简洁 越 
好 ,可 大 大 降低 测试 脚本 中 定位 表达 式 的 维护 成 本 。 

3. 使 用 索引 号 定位 元 素 

索引 号 表示 某 个 被 定位 的 页 面 元 素 在 其 父 元 素 节 点 下 的 同名 元 素 中 的 位 置 序号 ,需要 
从 1 开始 。 

目的 : 

在 被 测试 网 页 中 ,查找 第 一 个 div 标签 下 的 “查询 ”按钮 。 

XPath 定位 表达 式 : 

//input[2] 

Python 定位 语句 : 

query = driver.find element by xpath("//input[2]") 

代码 解释 : 

索引 号 定位 方式 是 根据 该 页 面 元 素 在 页 面 中 相同 标签 名 之 间 出 现 的 索引 位 置 来 进行 定 
位 的 。 上 述 XPath 定位 表达 式 表示 查找 页 面 中 第 二 个 出 现 的 input 元 素 , 即 被 测试 页 面 上 
的 “查询 "按钮 。 


更 多 说 明 : 
若 在 Firefox 浏览 器 的 FirePath 插件 中 使 用 "//input[1]?” 定 位 表达 式 进 行 页 面 元 素 定 
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位 ,可 以 发 现在 被 测试 网 页 的 HTML 代码 区 域 高 亮 显示 了 两 行 代 码 , 两 个 div 标签 下 的 第 
一 个 input 标签 都 被 定位 到 ,这 和 只 查找 第 一 个 input 元 素 相 冲突 ,这 是 由 于 被 测试 网 页 中 
两 个 div 标签 下 都 包含 了 input 标签 ,XPath 在 查找 的 时 候 把 每 个 div 节点 都 当 作 相同 的 起 
始 层 级 开始 查找 ,所 以 用 “//input[1]” 表 达 式 会 同时 查找 到 两 个 div 节点 下 的 第 一 个 input 
元 素 。 如 果 在 两 div i% Fed Hx E div, H EL Hx EE BS div 下 也 有 input 标签 ,使 
“input[L1]? 定 位 表达 式 , 也 会 定位 到 藤 套 div 下 的 input 标签 ,也 就 是 说 无 论 嵌 套 多 少 层 
HTML 标签 ,只 要 这 些 HTML 标签 的 子 标签 里 有 input 标签 ,第 一 个 input 标签 都 会 被 定 
位 到 。 因 此 在 使 用 索引 号 定位 页 面 元 素 的 时 候 , 需 要 注意 网 页 HTML 代码 中 是 否 包 含 了 
多 个 层级 完全 相同 的 代码 结构 (比如 本 例 中 的 两 个 div 层级 ) , 若 出 现 了 这 种 情况 ,就 需要 修 
改定 位 表达 式 ,以 确保 自动 化 测试 脚本 中 使 用 的 定位 表达 式 能 唯一 定位 所 需要 的 页 面 元 素 。 
但 如 果 想 同时 定位 多 个 相同 input 页 面 元 素 , 可 以 使 用 如 下 Python 语句 : 




















inputList = driver.find elements by xpath("//input[1]") 


将 定位 的 多 个 元 素 存储 到 list 对 象 中 ,然后 根据 list 对 象 的 索引 号 获取 想 要 的 页 面 元 
素 。 但 如 果 发 现 页 面 元 素 会 经 常 增加 或 减少 ,就 不 建议 使 用 索引 号 定位 的 方式 ,因为 页 面 变 
化 很 可 能 会 让 使 用 索引 号 的 XPath 定位 表达 式 定位 失败 。 

基于 实例 中 的 被 测试 网 页 ,下 面 给 出 更 多 的 通过 索引 号 定位 的 实例 ,如 表 8-2 所 示 。 

表 8-2 

预期 定位 的 页 面 元 素 定位 表达 式 实例 使 用 的 属性 值 


div[last()] 表 示 最 后 一 个 div 元 素 ,last() 
函数 获取 的 是 指定 元 素 的 最 后 的 索引 号 





定位 第 二 个 div 下 的 超 链接 | //div[ lastO ]/a 








定位 第 一 个 div 中 的 超 链 接 | //div[Llast() 一 1]/a div[last() 一 1] 表 示 倒 数 第 二 个 div 元 素 
定位 最 前 面 一 个 属于 div 元 uw " . position ) PR CK bU iii 26 3X. input 的 位 置 
素 的 子 元 素 中 的 input 元 素 //div/input[ position()<2] 序列 号 








4. 使 用 页 面 元 素 的 属性 值 定位 元 素 

在 定位 页 面 元 素 的 时 候 , 经 常会 遇 到 各 种 复杂 结构 的 被 测试 网 页 ,并 且 很 多 页 面 元 素 也 
没有 设计 ID, Name 等 属性 ,同时 又 不 想 使 用 绝对 路 径 或 索引 号 来 定位 页 面 元 素 , 但 是 发 现 
要 被 定位 的 页 面 元 素 拥有 某 些 固定 不 变 的 属性 及 属性 值 , 此 时 推荐 使 用 属性 定位 方式 来 定 
位 页 面 元 素 。 

目的 : 

定位 被 测试 网 页 中 的 第 一 张 img 元 素 。 

XPath 定位 表达 式 : 

//ing[@alt= "divi - imgl"] 

Python 定位 语句 : 


img = driver. find element by xpath('//ing[@alt="divl- imgl"]') 


代码 解释 : 
表达 式 使 用 了 相对 路 径 再 结合 元 素 拥有 的 特定 属性 的 方法 进行 定位 ,定位 元 素 img 的 
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属性 是 "alt” ,其 属性 值 为 “divl-img1”, 使 用 @ 符 号 指明 后 面 接 的 是 属性 ,并 同属 性 及 属性 值 
一 起 写 到 元 素 后 的 方 括号 中 。 

更 多 解释 : 

被 测试 网 页 的 元 素 通常 会 包含 各 种 各 样 的 属性 值 , 并 且 很 多 属性 值 具有 唯一 性 。 若 能 
确认 属性 值 不 常 变 并 且 唯 一 ,强烈 建议 使 用 相对 路 径 再 结合 属性 的 定位 方式 来 编写 XPath 
定位 表达 式 ,使 用 此 方法 可 以 解决 99% 的 页 面 元 素 定 位 难题 。 基 于 实例 中 的 被 测试 网 页 ， 
下 面 给 出 更 多 的 属性 值 定位 实例 ,如 表 8-3 所 示 。 

表 8-3 


预期 定位 的 页 面 元 素 定位 表达 式 实 例 


//img[@ href = ' http://www. sogou. 


使 用 的 属性 值 





定位 页 面 的 第 一 张 图 片 使 用 img 标签 的 href 属性 值 


com' ] 


定位 第 二 个 div 中 第 一 个 | //div[ € name = ' div2' ]/input[ ( name | 使 用 div 标签 的 name 属性 值 





input 输入 框 


= 'div2input' | 


使 用 input 标签 的 name 属性 值 





定位 第 一 个 div 中 的 第 一 个 
链接 


//div[ (& id = ' divl ' J/a[ (à href = 


' http://www. sogou. com' ] 


使 用 div 标签 的 ID 属性 值 
使 用 a 标签 的 href 属性 值 





定位 页 面 的 查询 按钮 





/ /input[ (9 type— ' button' ] 





使 用 type 属性 值 


5. 使 用 模糊 属性 值 定位 元 素 

模糊 属性 值 定位 方式 表示 使 用 属性 值 的 一 部 分 内 容 进行 定位 。 在 自动 化 测试 的 实施 过 
程 中 ,常常 会 遇 到 页 面 元 素 的 属性 值 是 动态 生成 的 ,也 就 是 说 每 次 访问 属性 值 都 不 一 样 , 此 
类 页 面 元 素 会 加 大 定位 难度 ,使 用 模糊 属性 值 定位 方式 可 以 解决 一 部 分 此 类 难题 ,但 前 提 是 
属性 值 中 有 一 部 分 内 容 保 持 不 变 。XPath 提供 了 一 些 可 实现 模糊 属性 值 的 定位 需求 的 函 
数 , 如 表 8-4 所 示 。 

表 8-4 


XPath 函数 定位 表达 式 实例 表达 式 解 释 


查找 属性 alt 的 属性 值 以 *div1 "关键 字 开 
始 的 页 面 元 素 

查找 alt 属性 的 属性 值 包含 “img ”关键 字 的 
页 面 元 素 , 只 要 包含 即 可 ,无 须 考虑 位 置 





starts-with(strl, str2) | / /img[ starts-with( (2 alt. 'div1') ] 





contains( (strl, str2) / /'img| contains( (2alt, 'img') ] 











contains) 函数 属于 XPath 的 高 级 用 法 ,使 用 场景 比较 多 ,尽管 页 面 元 素 的 属性 值 经 常 
发 生变 化 ,但 只 要 其 属性 值 有 几 个 固定 不 变 的 关键 词 ,就 可 以 使 用 contains O 函数 进行 
定位 。 

6. 使 用 XPath 轴 (Axes) 定 位 元 素 

轴 可 以 定义 相对 于 当前 节点 的 节点 集 。 使 用 XPath(Axes) 定 位 方式 可 根据 在 文档 树 
中 的 元 素 相 对 位 置 关 系 进行 页 面 元 素 定 位 。 先 找到 一 个 相对 好 定位 的 元 素 ,让 它 作 为 轴 , 根 
据 它 和 要 定位 元 素 间 的 相对 位 置 关系 进行 定位 ,可 解决 一 些 元 素 难以 定位 的 问题 。 

根据 本 节 提 供 的 被 测试 网 页 HTML 代码 , 画 出 一 棵 图 形 化 文档 树 状 图 ,如 图 8-1 所 示 。 
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XPath 常用 轴 关 键 字 如 表 8-5 所 示 。 
表 8-5 
XPath $h 
关键 字 轴 的 含义 说 明 定位 表达 式 实例 表达 式 解释 





" a 3 asas | 查找 到 属性 alt 的 属性 值 为 div2-img2 
patent 选择 当前 节点 的 上 层 | //img[ @alt= ' div2-img2 的 img 元 素 , 并 基于 该 img 元 素 的 位 


iini Make HRANE E — At div 页 面 元 素 
选择 当前 节点 的 下 层 | //div[@ id= ' div ]/ | ESP DMEM div] ff div 元 素 ， 


child 并 基于 div 的 位 置 找到 它 下 层 节点 中 
本 站- hild; :i 
KATER ai 的 img 页面 元 素 


I E tdi iion 查找 到 属性 alc 的 属性 值 为 div2-img2 
选择 当前 节点 所 有 上 | //imgl (9alt— ' div2-img2 的 img 元 素 , 并 基于 该 img 元 素 的 位 


TS dapi Sd 置 找到 它 上 级 的 div 页 面 元 素 
选择 当前 节点 所 有 下 | //div[@ name 二 "div2']/ | 查找 到 属性 name 的 属性 值 为 div2 的 
descendant 层 的 节点 (子孙 等 ) | descendant; cim div 页 面 元 素 , 并 基于 该 元 素 的 位 置 找 
TEES ` idus 到 它 下 级 所 有 节点 中 的 img 页 面 元 素 
查找 到 TD 属性 值 为 divl 的 div 页 面 
A RID aus NOTE 
zi T ide 点 中 的 img 页 面 元 素 
Ja EG href "https // 查找 到 链接 地 址 Ai YA 
following- | 选择 当前 节点 后 续 所 sogou. com 的 链接 页 面 元 素 a, 并 基于 
www. sogou. com ' ]/ 


sibling 有 兄弟 节点 e 链接 的 位 置 找到 它 后 续 兄 弟 节点 中 的 
following-sibling: :input 
input 页 面 元 素 


| EBERUR PE alt 的 属性 值 为 div2-img2 
选择 前 lt= 'div2-i 2' 
preceding AFAM PANEI | //imel@ale= "div2-img2! EER iE FE 


点 ding: :di P 
Vilis Vpred 置 找到 它 前 面 节点 中 的 div 页 面 元 素 


























查找 到 value 属性 值 为 “查询 "的 输入 
preceding- | 选择 当前 节点 前 面 的 | //input[ € value — ' s ig ' | 框 页 面 元 素 ,并 基于 该 输入 框 的 位 置 
sibling 所 有 兄弟 节点 J/preceding-sibling: :aL1] | 找到 它 前 面 同 级 节点 中 的 第 一 个 链接 
页 面 元 素 














更 多 说 明 : 
有 时 候 我 们 会 在 轴 后 面 加 一 个 星 号 ( * ) ,表示 通配符 ,比如 //inputL@value 一 ' 查 询 ']/ 
preceding-sibling: : * , 它 表示 查找 属性 value 的 值 为 查询 ”的 输入 框 input 元 素 前 面 所 有 
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的 同 级 元 素 ,但 不 包括 input 元 素 本 身 。 
7. 使 用 页 面 元 素 的 文本 定位 元 素 
通过 text() 函 数 可 以 定位 到 元 素 文本 包含 某 些 关 键 内 容 的 页 面 元 素 。 
XPath 表达 式 : 
(D //a[text O =" R 5638 28" ] 
(2) //a[. = 二 "搜狗 搜索 "] 
(3) //a[containsC. ，" 百 度 ")] 
(4) //aLcontains(text()，" 百 度 ")] 
(5) //aLcontains(text(), "H JE") ]/preceding::div 
(6) //a[containsC. , "A EE") ]/. . 
Python 定位 语句 : 
sogou a = driver.find element by xpath('//a[text() = "搜狗 搜索 "]') 
sogou a = driver.find element by xpath('//a[. = "搜狗 搜索 "] 
baidu a = driver.find element by xpath('//a[contains(., "百度 ")]') 
baidu a = driver.find element by xpath('//a[contains(text(), "百度 ")]') 
div = driver.find element by xpath('//a[contains(text(), "Ti HE") ]/preceding: :div') 
div = driver.find element by xpath('//a[contains(., "T1 E") ]/. . ') 
代码 解释 : 
> XPath 表达 式 1 和 表达 式 2 等 价 , 都 是 查找 文本 内 容 为 "搜狗 搜索 "的 链接 页 面 元 素 ， 
使 用 的 是 精准 匹配 方式 ,也 就 是 说 文本 内 容 必 须 完 全 匹配 ,不 能 多 一 个 字 也 不 能 少 
一 个 字 。 第 二 个 XPath 语句 中 使 用 了 一 个 点 (. ) ,这 里 的 点 等 价 于 text O PRG. HR 
代 的 是 当前 节点 的 文本 内 容 。 
> XPath 表达 式 3 和 表达 式 4 等 价 .都 是 查找 文本 内 容 包含 “百度 ”关键 字 的 链接 页 面 
元 素 ,使 用 的 是 模糊 匹配 方式 , 即 可 以 根据 部 分 文本 关键 字 进 行 匹配 。 
> XPath 表达 式 5 和 表达 式 6 等 价 , 都 是 查找 文本 内 容 包 含 “ 百 度 ”" 关 键 字 的 链接 页 面 
元 素 a 的 上 层 父 元 素 div, 第 6 4J XPath 表达 式 最 后 使 用 了 两 个 点 (.. ), 它 表示 选取 
当前 节点 的 父 节点 ,等 价 于 preceding: :div。 
更 多 说 明 : 
使 用 文本 内 容 匹配 模式 进行 定位 ,为 定位 复杂 的 页 面 元 素 又 提供 了 一 种 强大 的 定位 模 
式 , 在 遇 到 定位 困难 时 ,可 以 优先 考虑 使 用 此 方式 进行 定位 。 建 议 读 者 对 此 定位 方式 进行 大 
量 练习 ,以 便 做 到 可 随意 定位 页 面 元 素 中 的 任意 元 素 。 
8.8.4 XPath 运算 符 
XPath 也 提供 了 一 些 运算 符 来 更 好 地 支持 定位 页 面 元 素 ,XPath 表达 式 可 返回 节点 集 、 
字符 串 、 逻 辑 值 以 及 数字 等 ,读者 可 以 根据 自己 的 需求 选择 使 用 。 
被 测试 网 页 的 HTML 代码 : 


<html> 
<body> 
<div id= "divl" style = "text - align :center"> 
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< img alt = "divl- imgl" 
src = "http://www. sogou. com/images/10go/new/sogou. png" 
href = "http://www. sogou. com"> 搜 狗 图 片 </ing><br /> 
<a>10</a> 
< span> 13 </span > 
< input name = "divlinput"> 
<a href = "http://www. sogou. com"> 搜 狗 搜索 </a> 
< input type = "button" value = "查询 "> 
</div> 
<br> 
<div name = "div2" style= "text 一 align:center"> 
< img alt = "div2- img2" src = "http://www. baidu. com/img/bdlogo. png" 
href = "http://www. baidu. com"> 百 度 图 片 </img><br /> 
< input name = "div2input"> 
<a href = "http: //www. baidu. com"> 百 度 搜 索 </a> 
</div> 
</body> 
</html > 
XPath 运算 符 如 表 8-6 所 示 。 
表 8-6 
XPath 
运算 符 £ x m s 表达 式 解 释 
| 获取 两 个 或 多 个 | //div|//a 返回 所 有 拥有 div 和 a 元 素 的 节点 集 
节点 集 / /div| / /a| / /input 返回 所 有 拥有 div 和 a 以 及 input 元 素 的 节点 集 
FIFe 
+ 两 数 或 多 数 连 加 //div[1+1] 返回 数字 4 查找 页 面 中 第 二 个 div 元 素 
= 两 数 或 多 数 连 减 | 10 一 1 一 3 返回 数字 6 
* 两 数 或 多 数 连 乘 | 2* 1* 4 返回 数字 8 
div | 两 数 或 多 数 连 除 | 10 div 2 返回 数字 5 
2 如 果 span 是 10, 返 回 true, 和 否则 返回 false; 
= | 等 于 2 查找 子 元 素 中 有 a 元 素 .并 且 其 文本 内 容 为 数字 且 
Hu 为 10 的 div 元 素 
//span! —12 如 果 span 不 是 12, 返 回 true, 和 否则 返回 false; 
! 一 | 不 等 于 查找 子 元 素 中 有 a 元 素 ,并 且 其 文本 内 容 为 数字 且 
//div[a! —10] E cs 
不 为 10 的 div 元 素 
如 果 span 小 于 12, 返 回 true, 否 则 返回 false s 
< | 小 于 (ern < UNUS 奏 扫 对 元 素 中 有 元素 ,并 且 其 文本 内 容 为 数字 是 
li 小 于 11 的 div 元 素 
如 果 span 小 于 等 于 12 ,返回 true, 和 否则 返回 false; 
//span<=12 sa i 
<= | 小 于 等 于 / /div[ ac —10] 查找 子 元 素 中 有 a 元 素 ,并 且 其 文本 内 容 为 数字 且 
li 小 于 等 于 10 的 div 元 素 
如 果 span 大 于 12. 返 回 true, 和 否则 返回 false; 
/ /span2-12 e ne 
> ETF Wi 查找 子 元 素 中 有 a 元 素 , 并 且 其 文本 内 容 为 数字 且 
/ /div[a7-9] ae 
大 于 9 的 div 元 素 
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续 表 





XPath 


— E S z 例 表达 式 解 释 





Merasi 如 果 span 大 于 等 于 12 ,返回 true, 和 否则 返回 false; 

>= DXTST / /div[ a» —10] 查找 子 元 素 中 有 a 元 素 , 并 且 其 文本 内 容 为 数字 且 
i 大 于 等 于 10 的 div 元 素 

如 果 span 大 于 1 并 且 span 小 于 等 于 3, 返回 true, 

否则 返回 false; 





//spanZ» 1 and span 


<=3 
and |5 /div [a — — 10 and | 查找 子 元 素 中 有 元素, 并 且 其 文本 内 容 为 数字 且 
i | 小 于 等 于 10, 同 时 满足 存在 子 元 素 span, 其 文本 内 


容 也 为 数字 且 等 于 13 的 div 元 素 

如 果 span 等 于 10 或 者 span 等 于 20, 返 回 true. 2 

=20 则 返回 false; 

or 或 //div[a < = 10 or 查找 子 元 素 中 有 a 元素 ,并 且 其 文本 内 容 为 数字 且 
小 于 等 于 10, 或 者 存在 子 元 素 span, 其 文本 内 容 也 

为 数字 且 等 于 13 的 div 元 素 

mod | 取 余 7 mod 3 返回 数字 1 


8.9 Mes xm 


CSS 定位 方式 和 XPath 定位 方式 很 类 似 , 能 够 解决 大 部 分 常见 的 定位 难题 。 如 果 读 者 
已 经 深入 掌握 了 XPath 定位 方式 的 使 用 方法 ,可 以 选择 跳 过 此 节 。 





//span = 10 or span 


span—13] 














8.9.1 CSS 的 概念 


CSS 是 英文 Cascading Style Sheets 的 缩写 ,中 文 意思 指 层 琶 样式 表 。CSS 是 一 种 用 于 表 
现 HTML 或 XML 等 文件 样式 的 前 端 页 面 语言 ,主要 用 于 描述 页 面 元 素 的 展现 和 样式 的 定义 。 


8.9.2 CSS 定位 语法 

CSS 定位 方式 和 XPath 定位 方式 基本 相同 ,只 是 CSS 定位 表达 式 有 其 自己 的 格式 。 
CSS 定位 方式 拥有 比 XPath 定位 速度 快 , 且 比 XPath 稳定 的 特性 。 下 面 详细 介绍 CSS 定位 
方式 的 使 用 方法 。 

被 测试 网 页 HTML 代码 : 


<html> 
<head> 
< style type = "text/css"> 
input. spread ( FONT- SIZE: 20pt;} 
input. tight ( FONT- SIZE: 10pt;] 
</style> 
</head> 
< body onload = "document. getElementBylId('divlinput').focus()"» 
<div id="div1" style= "text - align: center"> 
< input id= "divlinput" class = "spread"></input > 
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«a href = "http://www. sogou. com"> 搜 狗 搜索 </a> 
< img alt = "divl- imgl"src = http://www. sogou. com/ images/1ogo/new/sogou. png 
href = "http://www. sogou. com"> 搜 狗 图 片 </img> 
< input type = "button" value = "查询 "></input > 
</div> 
<br> 
<p> 第 一 段 文字 : 时 间 管 理 好 ,每 天 学 习 1 小 时 ,改变 只 会 手工 测试 的 命运 </p> 
<p> 第 二 段 文字 : 现在 不 努力 ,老大 搞 IT</p> 
<px 第 三 段 文字 : 1 万 小 时 理论 ,1 万 小 时 的 努力 和 积累 让 你 与 众 不 同 </p> 
< input type = "checkbox" > 学 习 </input> 
«div name = "div2" style = "text - align: center"> 
< input name = "div2input" class= "tight"></input> 
<a href = "http: //www. baidu. com"> 百 度 搜 索 </a> 
< ing alt = "div2- img2" src= "http://www. baidu. com/ ing/bdlogo. png" 
href = "http://www. baidu. com"> H J£ [5] Hr «/ img» 
</div> 
<div class = "foodDiv"> 
<ul id = "recordlist"» 


<p> 土 豆 </p> 
<1i> 黄 瓜 </1i> 
<1i> 西 红 柿 </1i> 
<1i> 冬 瓜 </1i> 
«li» </li> 
</ul> 
</div> 
«/ body > 
</html > 


使 用 上 面 HTML 代码 生成 被 测试 网 页 ,基于 此 网 页 来 实践 各 种 不 同 的 页 面 元 素 的 
CSS 定位 方法 。 
1. 使 用 绝对 路 径 定 位 元 素 


目的 : 

在 被 测试 网 页 中 ,查找 第 一 个 div 元 素 中 的 “查询 ”按钮 。 
CSS 定位 表达 式 : 

html > body > div > input[value = "查询 "] 

Python 定位 语句 : 


query = driver.find element by css selector('htnl» body? div> input[value= "查询 "]') 


代码 解释 : 

上 述 CSS 定位 表达 式 使 用 绝对 路 径 定 位 属性 value 的 值 为 “查询 ”的 页 面 元 素 。 从 CSS 
定位 表达 式 可 以 看 出 , 步 间 通过 “>” 符 号 分 割 .区 别 于 XPath 路 径 中 的 正 斜 杜 (/) ,并 且 也 不 
再 使 用 @ 符 号 选择 属性 。 


不 推荐 在 频繁 变化 的 被 测试 页 面 上 使 用 绝对 路 径 方式 定位 页 面 元 素 。 
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2. 使 用 相对 路 径 定位 元 素 

目的 : 

在 被 测试 网 页 中 ,查找 第 一 个 div 元 素 中 的 “查询 ”按钮 。 

CSS 定位 表达 式 : 

input[ value = "查询 "] 

Python 定位 语句 : 

query = driver.find element by css selector('input[value = "查询 "]') 

代码 解释 : 

上 述 CSS 表达 式 通 过 相对 路 径 使 用 元 素 名 称 和 元 素 的 属性 及 属性 值 进行 页 面 元 素 的 
定位 。 

3. 使 用 class 名 称 定位 元 素 

目的 : 

在 被 测试 网 页 中 ,查找 第 一 个 div 元 素 下 的 input 输入 框 。 

CSS 定位 表达 式 : 

input. spread 

Python 定位 语句 : 

input = driver.find element by css selector('input. spread') 

代码 解释 : 

上 述 CSS 定位 表达 式 使 用 input 页 面 元 素 的 class 属性 名 称 spread 来 进行 定位 ,用 点 
(. ) 分 割 元 素 名 与 class 属性 名 ,点 号 后 面 是 class 属性 名 称 。 

4. 使 用 ID 属性 值 定位 元 素 

目的 : 

在 被 测试 网 页 中 ,查找 第 一 个 div 元 素 下 ID 属性 值 为 “divlinput” 的 input 页 面 元 素 。 

CSS 定位 表达 式 : 

input # divlinput 

Python 定位 语句 : 

input = driver.find element by css selector('input£ divlinput') 

代码 解释 : 

上 述 CSS 定位 表达 式 使 用 input 页 面 元 素 的 ID 属性 值 "divlinput” 进 行 定位 ,使 用 "并 ” 
号 分 割 元 素 名 和 ID 属性 值 .“# ”后 面 是 ID 属性 值 。 

5. 使 用 页 面 其 他 属性 值 定位 

目的 : 

在 被 测试 网 页 中 ,查找 div 元 素 下 的 第 一 张 图 片 元素 img. 
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CSS 定位 表达 式 : 

表达 式 l: img[alt- "divl imgl"] 

KIKI 2; img[alt- "divl imgl"][href = "http://www. sogou. con" ] 

Python 定位 语句 : 

img = driver.find element by_css_selector('img[alt= "divl- imgl"]') 

img = driver.find element by css selector('img[alt = "divl- ingl"][href = " 

http://www. sogou. con" ] ') 

代码 解释 : 

> CSS 表达 式 1 和 CSS 表达 式 2 在 本 章节 提供 的 被 测试 网 页 中 是 等 价 的 ,都 是 定位 的 
第 一 个 div 元 素 下 的 img 元 素 。 

> CSS 表达 式 1: 表示 使 用 img 页 面 元 素 的 alt 属性 值 "divl-imgl? 进 行 定 位 。 若 想 定 
位 的 页 面 元 素 始终 具有 唯一 的 属性 值 , 此 定位 方法 可 解决 页 面 频繁 变化 的 部 分 定位 
难题 。 

> CSS 表达 式 2: 表示 同时 使 用 了 alt 属性 和 href 属性 进行 页 面 元 素 的 定位 。 在 某 些 
复杂 的 定位 场景 ,可 使 用 多 个 属性 来 确保 定位 元 素 的 唯一 性 。 

6. 使 用 属性 值 的 一 部 分 内 容 定位 元 素 

目的 : 

在 被 测试 网 页 中 ,查找 “搜狗 搜索 ”链接 。 

CSS 定位 表达 式 : 

表达 式 1: a[href ^ = "http://www. so"] 

表达 式 2; a[href $ = "gou.con"] 

表达 式 3: a[href x = "so"] 

Python 定位 语句 : 

a = driver.find element by css selector('a[href ^ = "http://www. so" ]') 

a = driver.find element by css selector('a[href $ = "gou. con" ]') 

a = driver.find element by css selector('a[href * = "so"]') 

代码 解释 : 

> 上 述 三 个 CSS 定位 表达 式 在 本 章 提供 的 被 测试 网 页 中 是 等 价 的 ,都 是 查找 “搜狗 搜 
索 " 链 接 。 

> CSS 表达 式 1: 表示 匹配 链接 地 址 开始 包含 “http://www. so" 关 键 字 串 的 链接 元 
素 ,以 字符 “*” 指 明 从 字符 串 的 开始 匹配 。 

> CSS 表达 式 2: 表示 匹配 链接 地 址 结尾 包含 "gou. com” 关 键 字 串 的 链接 元 素 ,以 字符 
“$ "指明 在 字符 串 的 结尾 匹配 。 

> CSS 表达 式 3: 表示 匹配 链接 地 址 包含 “so" 关 键 字 串 的 链接 元 素 , 以 符号 "* ”指明 
需要 进行 模糊 匹配 。 

更 多 说 明 : 

使 用 此 模糊 定位 方式 ,可 匹配 动态 变化 的 属性 值 的 页 面 元 素 , 只 要 找到 属性 值 固定 不 变 


的 关键 部 分 ,就 可 以 进行 模糊 匹配 定位 。 此 方法 可 以 解决 大 部 分 复杂 定位 的 难题 。 
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7. 使 用 页 面 元 素 进行 子 页 面 元 素 的 查找 

目的 : 

在 被 测试 网 页 中 ,查找 第 一 个 div 下 的 第 一 个 input 页 面 元 素 。 
CSS 定位 表达 式 : 

表达 式 l: div# divl > input £ div input 

表达 式 2: div input 

Python 定位 语句 : 


input = driver.find element by css selector('divi divl > input#divlinput') 
inputList - driver.find elements by css selector('div input') 


代码 解释 : 

> CSS 表达 式 1 中 的 div# div1 ,表示 在 被 测试 网 页 上 定位 到 ID 属性 值 为 divl 的 div 
页 面 元 素 ,“>” 表 示 在 以 查找 到 的 div 元 素 的 子 页 面 元 素 中 进行 查找 ,input # 
divlinput 表示 查找 ID 属性 值 为 divlinput 的 input 页 面 元 素 。 此 方法 可 实现 查找 
div 下 子 页 面 元 素 的 目的 。 

> RAR 2 表示 匹配 所 有 属于 div 元 素 后 代 的 input 元 素 , 父 元 素 div 和 子 元 素 input 
间 必 须 用 空格 分 隔 。 

8. 使 用 伪 类 定位 元 素 

目的 : 

在 被 测试 网 页 中 ,查找 第 一 个 div 下 的 指定 子 页 面 元 素 。 

CSS 定位 表达 式 : 

表达 式 1: div#divl :first- child 

KIKI 2. div#divl :nth- child(2) 

表达 式 3: div# divl :last- child 

表达 式 4: input:focus 

表达 式 5: input:enabled 

表达 式 6: input:checked 

表达 式 7: input:not([id]) 

Python 定位 语句 : 

frist elem = driver.find element by css selector('div£divl :first- child') 

second elem = driver.find element by css selector('div£divl :nth- child(2)') 

last elem = driver.find element by css selector('div£divl :last- child') 

focus = driver.find element by css selector('input:focus') 

enabled = driver.find elements by css selector('input:enabled') 


checked = driver.find elements by css selector('input:checked') 
inputList - driver.find elements by css selector('input:not([id])') 


代码 解释 : 
伪 类 表达 式 是 CSS 语法 支持 的 定位 方式 ,前 三 个 CSS 定位 表达 式 要 特别 注意 的 是 ,在 
冒号 (: ) 前 一 定 要 有 一 个 空格 ,否则 就 会 定位 不 到 期 望 的 页 面 元 素 。 
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> CSS 表达 式 1: 表示 查找 ID 属性 值 为 divl 的 div 页 面 元 素 下 的 第 一 个 子 元 素 ,参考 
被 测试 网 页 的 HTML 可 以 看 到 定位 到 的 页 面 元 素 是 input 元素, :first-child 表示 查 
找 某 个 页 面 元 素 下 的 第 一 个 子 页 面 元 素 。 

> CSS 表达 式 2: 表示 查找 ID 属性 值 为 divl 的 div 页 面 元 素 下 的 第 二 个 子 元 素 ,参考 
被 测试 网 页 的 HTML 可 看 到 定位 到 的 页 面 元 素 是 一 个 链接 元 素 , :nth-child(2) 表 
示 查 找 某 个 页 面 元 素 下 的 第 二 个 子 页 面 元 素 , 如 果 改 成 :nth-child(3) 则 表示 某 个 页 
面 元 素 下 的 第 三 个 子 元素 , 以 此 类 推 。 

> CSS 表达 式 3 : 表示 查找 ID 属性 值 为 divl 的 div 页 面 元 素 下 的 最 后 一 个 子 元 素 , 参 
考 被 测试 网 页 的 HTML 可 看 到 定位 到 的 页 面 元 素 是 按钮 元 素 , :last-child 表示 查找 
某 个 页 面 元 素 下 的 最 后 一 个 子 页 面 元 素 。 

> CSS 表达 式 4: 表示 查找 当前 获取 焦点 的 input 页 面 元 素 。 

> CSS 表达 式 5: 表示 查找 可 操作 的 input 页面 元 素 。 

> CSS 表达 式 6: 表示 查找 处 于 勾 选 状态 的 checkbox 页 面 元 素 。 

> CSS 表达 式 7: 表示 查找 所 有 无 id 属性 的 input 页 面 元 素 。 

更 多 说 明 : 

伪 类 定位 方式 可 基于 子 元 素 的 相对 位 置 和 元 素 的 状态 进行 定位 ,此 定位 方式 可 解决 自 

动 化 测试 中 一 部 分 页 面 元 素 定 位 难 的 问题 。 

9. 查找 同 级 兄弟 页 面 元 素 

目的 : 

在 被 测试 网 页 中 ,查找 第 一 个 div 下 第 一 个 input 子 页 面 元 素 的 同 级 兄弟 页 面 元 素 。 

CSS 定位 表达 式 : 

表达 式 1: div#divl > input + a 

表达 式 2: div#divl > input + a+ img 

表达 式 3: div# divl > input + * +ing 

表达 式 4: ol# recordlist>p 一 1i 

Python 定位 语句 : 





a = driver.find element by css selector('divi£ divl > input + a') 

img = driver.find element by css selector('divitdivl» input + a+ ing!) 

img = driver.find element by css selector('div£divl» input + x* + img') 

tagList = driver.find elements by css selector('ulirecordlist > p--li') 

代码 解释 : 

> CSS 表达 式 1 : 表示 在 ID 属性 值 为 divl 的 div 页 面 元 素 下 ,查找 input 页 面 元 素 后 
面 的 同 级 且 临近 的 链接 元 素 ao 

> CSS 表达 式 2: 表示 在 ID 属性 值 为 divl 的 div 页 面 元 素 下 ,查找 input 页 面 元 素 和 
链接 元 素 后 面 的 同 级 且 临 近 的 图 片 元素 img. 

> CSS 表达 式 3: 表示 在 ID 属性 值 为 divl 的 div 页 面 元 素 下 ,查找 input 页 面 元 素 和 
任意 一 种 页 面 元 素 后 面 的 同 级 且 临 近 的 图 片 元 素 img, * 表示 任意 类 型 的 一 个 页 面 
元 素 , 只 能 表示 一 个 页 面 元 素 , 如 果 想 用 此 种 方法 查找 第 一 个 div 下 的 最 后 一 个 
input 元 素 ,表达 式 写法 为 div# divl>input+ » + * c input 3X div # divl 7 inputd- 
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a+ * +input z div # divl>input+a+img+ input 等 。 
> CSS 表示 式 4: 表示 在 ID 属性 值 为 recordlist 的 ul 页 面 元 素 下 ,查找 p 页 面 元 素 以 
后 所 有 的 【i 元素。 
更 多 说 明 : 
使 用 此 方法 可 基于 相对 位 置 和 页 面 元 素 类 型 来 定位 页 面 元 素 , 星 号 ( * ) 在 此 处 表示 通 
配 符 ,可 以 表示 任意 类 型 的 页 面 元 素 名 。 
10. 多 元 素 选择 器 
CSS 定位 方式 支持 多 元 素 选择 器 ,也 就 是 一 次 可 以 同时 选择 多 个 相同 的 标签 ,也 可 以 
同时 选择 多 个 不 同 的 标签 ,不同 标签 间 用 英文 的 逗号 (,) 隔 开 。 
目的 : 
在 被 测试 网 页 中 ,同时 选择 多 个 不 同 的 页 面 元 素 。 
CSS 定位 表达 式 : 


div£divl,input,a 

Python 定位 语句 : 

tagList = driver.find elements by css selector('div £ divl, input,a') 

代码 解释 : 

上 述 CSS 表达 式 表示 同时 查找 所 有 的 ID 属性 值 为 divl 的 div 元 素 , 所 有 的 input 元 
素 , 所 有 的 a 元 素 。 


8.9.3 XPath 定位 与 CSS 定位 的 比较 


XPath 定位 方式 与 CSS 定位 方式 很 相似 ,XPath 定位 功能 相对 更 强大 一 些 , 但 CSS 定 
位 方式 执行 速度 更 快 。 鉴 于 某 些 浏览 器 并 不 支持 CSS 定位 方式 ,并 且 一 般 在 自动 化 测试 实 
施 过 程 中 使 用 XPath 定位 方式 要 比 使 用 CSS 定位 方式 更 普遍 ,所 以 建议 读者 优先 掌握 
XPath 定位 方式 。 

XPath 和 CSS 3 常用 表达 式 语 法 比较 如 表 8-7 所 示 。 









































X 87 
定位 元 素 目标 XPath CSS3 

所 有 元 素 // * x 
所 有 的 div 元 素 //div div 
所 有 的 div 元 素 的 子 元 素 /div/ * div> * 
根据 ID 属性 获取 元 素 // * [&id— 'divl'] £ divl 
根据 class 属性 获取 元 素 // * [contains(@class,'spread')] . spread 
拥有 某 个 属性 的 元 素 // * [@her{] * [href] 
所 有 div 元 素 的 第 一 个 子 元 素 //div/ x [1] div> * :first-child 
所 有 拥有 子 元 素 a 的 div 元 素 //div[a] 无 法 实现 
input 的 下 一 个 兄弟 元 素 / /input/following-sibling: : * [1] input 十 x 
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8.10 EZEAN 


浏览 器 网 页 常常 会 包含 各 类 表格 ,自动 化 测试 工程 师 可 能 会 经 常 操作 表格 中 的 行 、 列 以 
及 某 些 特定 的 单元 格 , 因 此 熟练 掌握 表格 定位 方法 是 自动 化 测试 实施 过 程 中 必要 的 技能 。 


8.10.1 遍历 表格 所 有 的 单元 格 
被 测试 网 页 的 HTML 代码 : 

















<html> 
< body» 
«table width = "400" border = "1" id= "table"> 
<tr> 
« td align = "left"> 消 费 项 目 .. ..</th> 
<td align = "right"> 一 月 </th> 
<td align = "right"> 二 月 </th> 
</tr> 
<tr> 
<td align ="left"> 衣 服 </td> 
< td align = "right"» 1000 元 </td> 
< td align = "right"> 500 元 </td> 
</tr> 
<tr> 
<td align = "left"> 化 妆 品 </td> 
<td align = "right"> 3000 元 </td> 
<td align = "right"> 500 元 </td> 
</tr> 
<tr> 
< td align = "left"> 食 物 </td> 
<td align = "right"> 3000 元 </td> 
<td align = "right"> 650.00 元 </td> 
</tr> 
<tr> 
<td align = "left"> 总 计 </th> 
<td align = "right"> 7000 元 </th> 
<td align = "right"> 1150 元 </th> 
</tr> 
</table> 
</body> 
</html > 
被 测试 页 面 内 容 展 现 如 图 8-2 所 示 。 
消费 项 目 … 一 月 | 二 月 
ET 1000 元 | 500 元 
化妆品 3000 元 | 500 元 
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Python 实例 代码 : 


# encoding = utf -8 
from selenium import webdriver 


driver = webdriver.Firefox(executable path = "c:\\geckodriver" ) 
driver. get(r"D:\table. html") 
EGER id EURER 
table - driver.find element by id("table") 
Zl AE HS KR E P NAITI R 
trList - table.find elements by tag name("tr") 
assert len(trList) == 5, "表格 行 数 不 符 !" 
for row in trList: 
# ITIR, JE I — IT PANI R 
tdList = row. find elements by tag name("td") 
for col in tdList: 
H I e PHI, JETER OC NEPAL TRE 


print col. text + "WM", 


print 
driver. quit() 
输出 结果 : 
消费 项 目 . 一 月 m 
衣服 1000 元 500 元 
化 妆 品 3000 元 500 元 
食物 3000 元 650.00 元 
总 计 7000 元 1150 元 
实例 代码 逻辑 : 


(1) 先 获取 整个 表格 的 页 面 对 象 。 
table = driver.find element by id("table") 
(2) 在 表格 页 面 元 素 对 象 中 ,获取 所 有 的 tr 元 素 对 象 ,并 存储 在 trList 对 象 中 。 


trList = table.find elements by tag name("tr") 


(3) 循环 遍历 存储 表格 行 对 象 的 trList 对 象 ,每 获取 一 行 中 所 有 的 单元 格 对 象 (并 存储 
在 tdList 对 象 中 ) ,就 循环 遍历 一 次 ,并 将 每 个 单元 格 的 文本 内 容 输出 。 
for row in trList: 
# 遍历 行 对 象 ,并 获取 每 一 行 中 所 有 列 对 象 
tdList = row.find elements by tag name("td") 
for col in tdList: 
# 遍历 表格 中 的 列 , 并 打印 单元 格 内 容 
print col.text + "Vt", 
print 
代码 col. text 用 于 获取 单元 格 的 文本 内 容 。 
以 上 步骤 完成 表格 中 所 有 单元 格 的 遍历 输出 ,通过 遍历 可 以 实现 读 取 任 意 单元 格 内 容 
的 操作 。 
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8.10.2. 定位 表格 中 的 某 个 元 素 


目的 : 
在 被 测试 网 页 中 ,定位 显示 表格 的 第 二 行 第 二 列 单元 格 。 
XPath 表达 式 : 


// * [(Gid- 'table' ]/tbody/tr[2]/td[2] 





Python 定位 语句 : 
cell = driver.find element by xpath("// * [@ id= 'table']/tbody/tr[2]/td[2]") 


代码 解释 : 

表达 式 中 的 trL2] 表 示 第 二 行 ,tdL2] 表 示 第 二 列 ,组 合 起 来 就 是 第 二 行 第 二 列 的 单 
元 格 。 

CSS 表达 式 : 

table £ table» tbody > tr:nth- child(2)> td:nth- child(2) 


Python 定位 语句 : 


cell = driver.find element by css selector("table£i table>tbody>tr:nth- child(2)> 
td:nth- child(2)") 


代码 解释 : 
tr:nth-child(2) 表 示 第 二 行 ,td:nth-child(2) 表 示 第 二 列 , 组 合 起 来 就 是 第 二 行 第 二 列 
的 单元 格 。 


8.10.3 ”定位 表格 中 的 子 元 素 
被 测试 网 页 的 HTML RE: 





<html> 
<body> 
«table width = "400" border = "1" id= "table"> 
<tr> 
«td align = "left"> 消 费 项 目 ....</th> 
< td align = "right"> 一 月 </th> 
<td align = "right"> 二 月 </th> 
</tr> 
<tr> 
<tdalign= "left"> 衣 服 : 
< input type = 'checkbox'> 外 套 </input > 
< input type = 'checkbox'> 内 衣 </input > 
</td> 
<tdalign= "right">1000 元 </></td> 
<tdalign= "right"> 500 元 </td> 
</tr> 
<tr> 


< td align = "left"> 化 妆 品 : 
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< input type = 'checkbox'»ifij 8 «/ input > 
< input type = 'checkbox »jK ifi $& «/ input > 
</td> 
< td align = "right"» 3000 元 </td> 
< td align = "right"> 500 元 </td> 
</tr> 
<tr> 
<td align = "left" # : 
< input type = 'checkbox'> X É </ input > 
< input type = 'checkbox'> 蔬 菜 </input > 
</td> 
< td align = "right"> 3000 元 </td> 
< td align = "right"> 650.00 元 </td> 
</tr> 
<tr> 
«td align = "left"> 总 计 </th> 
<td align = "right"> 7000 元 </th> 
<td align = "right"> 1150 元 </th> 
</tr> 
</table> 
</body> 
</html > 


页 面 内 容 展现 如 图 8-3 所 示 。 


























消费 项 目 .… 一 月 | | 
衣服 目 外 套 目 内 衣 10007t; 50071. 
| 化 妆 品 Com COINS 3000 元 | 500 元 
few 日 主食 加 蔬菜 3000 元 | 650.00 元 
rm 7000 元 | 11507 
图 8-3 

目的 : 

在 被 测试 网 页 中 ,定位 表格 中 第 三 行 中 的 第 一 个 “面霜 ”文字 前 的 复 选 框 。 

XPath RA: 

//td[contains(., "fE3&") ]/input[1] 

Python 定位 语句 : 


checkbox = driver.find element by xpath('//td[contains(., "(Lji&")]/input[1]') 


代码 解释 : 

先 找到 包含 子 元 素 的 单元 格 ,在 此 单元 格 中 再 寻找 子 元 素 即 可 。 表 达 式 //td[Lcontains 
Co "化妆 ")] 表 示 模 糊 匹 配 文本 内 容 包 含 “ 化 妆 ” 关 键 字 的 单元 格 td ER. /input 1] zs d 
到 的 单元 格 td 下 的 第 一 个 input 子 元 素 。 也 可 以 通过 XPath 轴 方 式 来 查找 该 子 元 素 , 比 
如 //tdLeontains(text(),' 化 妆 ')]/ descendant: :input[ 1]. 
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第 二 篇 “实战 应 用 篇 
sos WebbDriver 的 多 浏览 器 测试 


本 章 主要 讲 WebDriver 编写 的 脚本 实例 在 不 同 浏览 器 上 执行 ,在 Selenium WebDriver 
官方 支持 的 浏览 器 中 ,这 里 只 针对 TE, Chrome 和 Firefox 这 三 个 浏览 器 进行 讲解 ,其 他 浏览 
器 (比如 Opera, Safari) 原 理 都 一 样 ,请 读者 自行 练习 。 





环境 准备 : 

CD 在 使 用 IE 浏览 器 进行 WebDriver 自动 化 测试 之 前 ,需要 从 http://docs. 
seleniumhq. org/download/ 网 站 上 下 载 一 个 WebDriver 连接 IE 浏览 器 的 驱动 程序 ,文件 名 
为 IEDriverServer. exe。 下 载 页 面 的 链接 如 图 9-1 所 示 。 


The Internet Explorer Driver Server 
This is required if you want to make use of the latest and greatest features of the WebDriver 
InternetExplorerDriver. Please make sure that this is available on your $PATH (or %PATH% on 





Windows) in order for the IE Driver to work as expected 64:38 (E35 c EHE T $6 
Download version 2.53.1 for (recommended) SZ bit windows JÐor 64 bit Windelys 1E 
CHANGELOG ECC 


32638 (E 55 debis TE 


Selenium Client & WebDriver Language Bindings 


图 91 
(2) 解压 下 载 后 的 压缩 文件 ,并 将 其 里 面 的 TEDriverServer. exe 文件 保存 在 本 地 磁盘 


的 任意 位 置 ,比如 C:\ 下 。 
基于 unittest 框架 的 Python 实例 代码 : 





#encoding= utf - 8 
from selenium import webdriver 
import unittest 


class VisitSogouBYIE(unittest. TestCase) : 
def setUp(self): 


# o IE ILS 
self.driver = webdriver.le(executable path = "c: VM EDriverServer") 


def test visitSogou(self): 
# Wie 
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self.driver.get(" http: //www. sogou. com" ) 
TED 4 pl Fd X HD FI hE 


print self.driver.current url 


def tearDown(self): 
# 退出 IE 
self.driver.quit() 


if name == ' main ': 


unittest.main() 
执行 输出 结果 : 
https://www. sogou. com/ 


Ran 1 test in 18.027s 


OK 


代码 解释 : 

CD 在 setUpO PR Zt roli ise webdriver. Ie() 方 法 获取 IE 浏览 器 的 对 话 实例 ,函数 所 传 
的 参数 executable_path = "c; WIEDriverServer" 458] Y WebDriver 连接 IE 浏览 器 所 用 驱 
动 程序 的 存放 路 径 。 

(2) 在 测试 方法 test_visitSogou() 中 实现 的 是 访问 搜狗 首页 ,并 打印 当前 网 页 访问 的 
网 址 。 

(3) 在 tearDown() 方 法 中 ,实现 关闭 浏览 器 实例 等 后 期 的 清理 工作 。 


9.2 Ei 





环境 准备 : 

(1) 需要 本 地 操作 系统 安装 Firefox 浏览 器 。 

(2) 如 果 用 的 Selenium 3. x 的 版 本 ,需要 下 载 WebDriver 连接 Firefox 浏览 器 的 驱动 
程序 文件 ,详细 操作 步骤 见 第 6.2 节 。 但 如 果 用 的 是 Selenium 2. x 版 本 , 则 不 需要 准备 驱 
动 程序 。 

基于 unittest 的 Python 实例 代码 : 

# encoding= utf - 8 


from selenium import webdriver 
import unittest 


class VisitSogouByFirefox(unittest. TestCase) : 
def setUp(self): 


# 启动 Firefox NJ w 2 
self.driver = webdriver.Firefox(executable path = "c: Wgeckodriver") 
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def test visitSogou(self): 
* 访问 检索 首页 
self. driver. get ("http://www. sogou. con" ) 
# 打印 当前 网 页 的 网 址 


print self.driver.current url 


def tearDown(self): 
# 退出 Firefox Nl w a 
self.driver.quit() 


if name == ' main ': 
unittest.main() 
更 多 说 明 : 
使 用 Firefox 浏览 器 进行 自动 化 测试 时 ,都 默认 Firefox 浏览 器 安装 在 默认 路 径 下 ,后 
续 章 节 也 一 样 , 如 果 未 安装 到 默认 路 径 下 ,解决 办 法 详 见 第 6.2 节 。 





环境 准备 : 

CD 使 用 WebDriver 在 Chrome 浏览 器 上 进行 测试 时 ,需要 从 http: / /chromedriver. 
storage. googleapis. com/index. html 网 站 下 载 WebDriver 操作 Chrome 浏览 器 的 驱动 程 
序 , 需 要 下 载 的 程序 文件 名 为 chromedriver. exe. 笔者 这 里 选择 的 是 最 新 2. 27 版 (注意 ， 
2.27 版 本 的 驱动 要 求 Chrome 浏览 器 版 本 必须 是 54. 0. 2840. 0 及 其 以 上 版 本 )。 下 载 页 面 
如 图 9-2 所 示 ,读者 可 以 根据 自己 的 操作 系统 类 型 选择 相应 的 版 本 进行 下 载 。 


Index of /2.27/ 


Name. Last modi fied Size ETag 





ip 2016-12-23 03:46:49 3.21MB  980387b5885beBf 69343baOf11ccTa9f 

16-12-21 23:29:59 3.18NB  cód21c8fecf&bdüb880b2c36692153ef 
2016-12-21 23:07:03  4.39MB  56d908397af997£04fab32c052260994 
2016-12-21 23:45:09 3.50MB 2125188a206e2258364c3e46f07724e5 
2016-12-23 18:28:41 0.01MB  c8e3leb43d3t9d913Tb4ecebd5d6bdT6 








图 92 


(2) 解压 下 载 后 的 文件 ,将 chromedriver. exe 程序 文件 保存 在 本 地 硬盘 的 任意 位 置 , 比 
如 C:\ 下 。 
基于 unittest 的 Python 实例 代码 : 


#encoding= utf - 8 
from selenium import webdriver 
import unittest 


class VisitSogouByChrome(unittest. TestCase) : 


~“ Ma 


e 
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def setUp(self): 
# 启动 Chrome Ù) Vi ds 
self.driver = webdriver.Chrome(executable path = "c: chromedriver") 


def test visitSogou(self): 
# WIS 
self.driver.get(" http: //www. sogou. com" ) 


# 打印 当前 网 页 的 网 址 


print self.driver.current url 


def tearDown(self): 
# 退出 Chrome Ùy Vi js 
self.driver.quit() 


if name  -- ' main ': 
unittest. main( ) 

说 明 : 

在 实施 自动 化 测试 过 程 中 ,经 常会 遇 到 正确 的 程序 执行 报错 ,而 且 有 些 错 报 得 还 不 清 不 
楚 。 此 时 我 们 应 该 首先 根据 错误 信息 检查 测试 代码 ,如果 在 确定 代码 没有 问题 的 情况 下 , 考 
虚 更 换 浏览 器 版 本 、 驱 动 版 本 等 方法 来 解决 ,因为 Selenium 3. x 版 本 开始 ,浏览 器 驱动 均 由 
各 浏览 器 官方 提供 支持 ,并 且 浏 览 器 的 更 新 速度 远 超 驱动 更 新 速度 ,由 此 出 现 驱动 不 兼容 最 
新 版 浏览 器 的 情况 也 很 正常 ,根据 笔者 的 经 验 ,一 般 通 过 降低 浏览 器 版 本 或 者 更 新 驱动 ,再 
或 者 更 换 浏览 器 等 都 能 解决 。 
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本 章 主要 讲解 WebDriver 常用 API 的 使 用 方法 ,所 有 实例 都 会 给 出 被 测试 网 页 的 
HTML 代码 或 者 被 测试 网 页 的 网 址 ,方便 读者 在 本 地 实践 。API 调用 代码 会 包含 在 以 
“test "命名 开始 的 方法 中 ,本章 不 再 痪 述 WebDriver 使 用 前 的 初始 准备 工作 以 及 用 于 测试 
的 浏览 器 准备 工作 。 读 者 只 需要 将 本 章节 提供 的 调用 API 的 测试 用 例 方 法 添加 到 完整 的 
unittest 单元 测试 框架 代码 中 即 可 执行 ,完整 的 unittest 框架 代码 请 参见 第 9 章 ,单元 测试 
框架 代码 替换 如 图 10-1 所 示 。 





from selenium import webdriver 


import unittest 
class VisitSogouByChrome (uni ttest. TestCase) 
def setUp(self): 


self, driver = webdriver.Chrome(ezecutable path = "c: Wchromedriver^) 


def test visitSogou(self): 


elf, driver. get "http://www. sogou com^) 





print self. driver. current url 


def tearDom(self) 


£ 苦 换 以 test 开 头 的 方法 或 者 在 单元 测试 类 中 增加 
elf.driver.quit() 以 test 开 头 的 测试 方法 
| paccm 
if nae = main 
图 10-31 
10.1 BE Sod b 

目的 : 
打开 浏览 器 访问 指定 的 网 址 。 
用 于 测试 的 网 址 : 


http://www. sogou. com 
调用 API 的 实例 代码 : 


def test visitURL(self): 
visitURL = "http://www.sogou. com" 


e 
e Selenium WebDriver 3.0 — 自动 化 测试 框架 实战 指南 





e 
# 通过 driver 对 条 的 get 方法 ,访问 指定 的 网 址 


self.driver.get(visitURL) 
assert self. driver.title.find(u" 搜 狗 搜索 引擎 " ) > = 0, "assert error" 


10.2 lab pei! 


目的 : 
本 节 所 讲 的 网 页 的 前 进 和 后 退 , 模 拟 的 是 浏览 器 上 的 前 进 和 后 退 功 能 。 
用 于 测试 的 网 址 : 


http://www. sogou. com 
http://www. baidu. com 


调用 API 的 实例 代码 : 


def test visitRecentURL( self): 
firstVisitURL = "http://www. sogou. com" 
secondVisitURL = "http://www. baidu. com" 
* PU sogou 音 页 
self.driver.get(firstVisitURL) 
* 然后 访问 baidu 首页 
self.driver.get(secondVisitURL) 
# 返 问 上 一 次 访问 过 的 搜狗 首页 
self. driver. back( ) 
# PPY IEIET E H 


self. driver. forward( ) 


10.3 WEEE 


目的 : 
通过 程序 实现 刷新 网 页 。 
用 于 测试 的 网 址 : 


http://www. sogou. com 


调用 API 的 实例 代码 : 


def test_refreshCurrentPage(self) : 
url = "http://www. sogou. com" 
self.driver.get(url) 
A Mir i Bi TA iT 


self. driver. refresh() 


10.4 EEPE 


目的 : 
将 浏览 器 窗口 全 屏 展示 。 
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用 于 测试 的 网 址 : 
http://www. baidu. com 
调用 API 的 实例 代码 : 


def test maximizeWindow( self) : 
url = "http://www. baidu. com" 
self.driver.get(url) 
# Bek MeN ME dE BI EL, 以 鲁 占 浇 整 个 电脑 屏幕 


self.driver.maximize window() 


10.5 Ey EAE EE En: eps 


目的 : 
改变 浏览 器 窗口 的 位 置 。 
用 于 测试 的 网 址 : 


http://www. baidu. com 
调用 API 的 实例 代码 : 


def test window position(self): 
url = "http://www. baidu. com" 
self.driver.get(url) 
# DRH pL ae dE BERE EU fo Pe, ER PLU EE HT e 
position - self.driver.get window position() 
print "当前 浏览 器 所 在 位 置 的 横 坐 标 :“，position[ 'x'] 
print "当前 浏览 器 所 在 位 置 的 纵 坐 标 :"“，position['Y'] 
A BUR E S TE DERE EIE PE 
self.driver.set window position(y- 200, x= 400) 
# BEBE TEE (0 PLUIE, BE ERU VE di AG fr Pe fei E 
print self.driver.get window position() 
更 多 说 明 : 
(1) 获取 的 浏览 器 位 置 是 指 浏览 器 左上 角 所 在 的 屏幕 上 的 位 置 ,返回 的 是 x,y 坐标 值 ， 
即 横 纵 坐标 。 
(2) get_window_position() 和 set_window_position() 方 法 在 部 分 浏览 器 的 部 分 版 本 上 


失效 。 


由 瓦 测 获取 并 设置 当前 窗口 的 大 小 


用 于 测试 的 网 址 : 
http://www. baidu.com 
调用 API 的 实例 代码 : 


def test window size(self): 


"121。 
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url = "http://www. baidu. com" 

self.driver.get(url) 

# HN MESE BI LI BU Kb, E PFR TI 

sizeDict = self.driver.get window size() 

print "当前 浏览 器 窗口 的 宽 : " ，sizeDict[ 'width'] 

print "当前 浏览 器 窗口 的 高 : "，sizeDict[ 'height'] 

# BEBRUM IE EI O KK A 

self.driver.set window size(width = 200, height = 400, windowHandle = 'current') 
# OBEPRU MEE BI ELA A DUE, BEC HE N V e BI ELA I fei B 


print self.driver.get window size(windowHandle - 'current') 


10.7 BE bd EMEN CE 属性 值 


用 于 测试 的 网 址 : 


http://www. baidu. com 
调用 API 的 实例 代码 : 


def test getTitle(self): 
url = "http://www. baidu. com" 
self.driver.get(url) 
# WJH driver 的 title Bi FEK Ik T HHY title BE tE ffi 
title = self. driver. title 
print "当前 网 页 的 title 属性 值 为 : "，title 
* Mig gu title R tE cmE"mE— F, fr Bk anii" 
self.assertEqual(title，u" 百 度 一 下 ,你 就 知道 "，" 页 面 title 属性 值 错 误 !") 


更 多 说 明 : 
获取 页 面 的 title 属性 值 ,在 自动 化 测试 中 一 般 用 于 断言 是 否 成 功 打开 了 某 个 网 址 ,来 
证 明 测试 过 程 的 正确 性 。 


10.8 ERTA 





原 代码 


用 于 测试 网 址 : 
http://www. sogou. com 
调用 API 的 实例 代码 : 


def test_getPageSource( self) : 
url = "http://www. sogou. com" 
self.driver.get(url) 
# 调用 driver 的 page source [8 TE 3K Jl Va IB Jg P3 
pageSource - self.driver.page source 
# 打印 页 面 源码 
print pageSource 
# Br EC PED JE EA "A "KEF, PUITS D T g T 4E 8 IE 
self.assertTrue(u" 新 闻 ” in pageSource, "页 面 源码 中 未 找到 “新 闻 关键 字 ") 
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10.9 ER EAn ASE 


用 于 测试 的 网 址 : 
http://www. sogou. com 
调用 API 的 实例 代码 : 


def test getCurrentPageUrl(self): 
url = "http://www. sogou. com" 
self.driver.get(url) 
# 获取 当前 页 面 的 URL 
currentPageUrl = self.driver.current url 
# TED S pii URL 
print currentPageUrl 
# MEREDITH E JE 8$. https://www. sogou. com/ 
self.assertEqual(currentPageUrl, 


"https://www. sogou. com/"," 当 前 网 页 网 址 非 预期 !" ) 
中 天 [获取 与 切换 浏览 器 窗口 句柄 


目的 : 
获取 所 有 打开 窗口 的 句柄 ,并 在 这 些 句柄 间 互 相 切换 。 
用 于 测试 网 址 : 


http://www. baidu. com 


调用 API 的 实例 代码 : 


def test operateWindowHandle(self): 
url - "http://www.baidu. com" 
self.driver.get(url) 
# H dh e D GB 
now handle - self.driver.current window handle 
# 打印 当前 获取 的 窗口 句柄 
print now handle 
# HH Adda A "selenium" 
Self.driver.find element by id("kw"). send keys("w3cschool") 
# uidüseie f 
self.driver.find element by id("su").click() 
£ FA time fg 
import tine 
E SERE 3 Fb, A fE SLICE IR. 
tine. sleep(3) 
# fi w3school 在 线 教育 链接 
Self.driver.find element by xpath('//div[@id="1"]//altext()="w3"]').click() 
time. sleep(5) 
# KRA B O Ai 
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all handles = self.driver. window handles 
print "++++", self.driver.window handles[ - 1] 
* dil FF ill Hy PIE ETT T HO BICI I] fI, E RE 4E ÁN Ed E EET 
for handle inall handles: 
if handle !- now handle: 
* fiih EEFE AY A O AA 


切换 窗口 ,也 可 以 用 下 面 的 方法 ,但 此 种 方法 在 selenium 3. x 以 后 官方 已 经 不 推荐 使 
用 了 : 








self. driver. switch to window(handle) 


# AB 

Self. driver. switch to.window(handle) 

# nul; HTML5 fi f 

self. driver. find element by link text('HTMLS').click() 
time. sleep(3) 

# 关闭 当前 的 窗口 

self.driver.close() 

time.sleep(3) 

eT EBIU HB 

print now handle 

# AMENA 

self.driver.switch to.window(now handle) 

time. sleep(2) 

self.driver.find element by id("kw").clear() 

self. driver. find element by id("kw").send keys( 几 光荣 之 路 自动 化 测试 培训 ") 
Self.driver.find element by id("su").click() 

time. sleep(5) 


更 多 说 明 : 

(1) driver. switch_to_window() 方 法 在 selenium 3. x 版 本 以 后 ,官方 开始 推荐 使 用 
driver. switch to. window() 方 法 代替 。 

(2) driver. window handles 以 列表 对 象形 式 返 回 所 有 打开 窗口 的 句柄 ,包括 主 窗口 ， 
可 以 通过 driver. window_handles[ 一 1] 来 获取 当前 打开 窗口 的 句柄 。 


10.11 MESS ba ES 


用 于 测试 的 网 址 : 
http://www. baidu. com 
调用 API 的 实例 代码 : 


def test getBasicInfo(self): 
url = "http://www. baidu. com" 
# 访问 百度 首页 


self.driver.get(url) 
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newsElement = self.driver.find element by xpath("//a[text() = ' 新 闻 ']") 
* 获取 查找 到 的 "新 闻 " 链 接 元 莱 的 基本 信息 

print u" 元 素 的 标签 名 : ", newsElement.tag name 

print u" 元 素 的 size: ", newsElement. size 


输出 结果 : 


元 素 的 标签 名 : a 
元 素 的 size: ('width': 26, 'height': 24} 


更 多 说 明 : 
通过 调用 已 定位 元 素 内 建 的 一 些 属性 和 方法 ,可 以 查看 元 素 的 基本 信息 ,能够 更 好 地 支 
持 自动 化 的 实施 。 


10.12 EER O oe SES 


用 于 测试 的 网 址 : 
http://www. baidu. com 
调用 API 的 实例 代码 : 


def test getWebElementText(self): 
url = "http://www. baidu. com" 
# 访问 百度 首页 
self.driver.get(url) 
import tine 
time. sleep(3) 
* 通过 xpath EARE id 属 性 值 为 "u1" 的 div GÆ F MR — NEEE 
aElement = self.driver.find element by xpath("// * [(2 class = 'mnav' ][1]") 
A HIE SII E BEOU SEXE 8 0 text [n TE SIBI BE HETER hI XE ALT 
a text - aElement. text 
self.assertEqual(a text, u"f&3K" ) 


10.13 MEJE opo EU 


用 于 测试 的 HTML 代码 : 


<html> 
<head> 
«title» HTML 中 显示 与 隐藏 元 素 </title> 
< meta http- equiv = "Content - Type" content = "text/html; charset = utf — 8" /> 
< script type = "text/javascript"» 
function showAndHiddeni( )( 

var divi = document. getElementById("divi"); 

var div2 = document. getElementById("div2"); 

if (div1. style. display == 'block') div1. style. display = 'none'; 

else div1. style. display = 'block'; 
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if(div2. style. display == 'block') div2. style. display = 'none'; 
else div2. style. display = 'block'; 


} 
function showAndHidden2( ){ 
var div3 = document. getElementById("div3"); 
var div4 = document. getElementById("div4"); 
if(div3.style.visibility == 'visible') div3. style. visibility= 'hidden'; 


else div3. style. visibility= 'visible'; 
if(div4.style.visibility == 'visible') div4.style. visibility= 'hidden'; 
else div4.style.visibility- 'visible'; 


) 


</script> 
</head> 
<body> 


<div> display: 元 素 不 占用 页 面 位 置 </div> 

«div id= "divl" style = "display:block;"» DIV 1 </div> 

<div id= "div2" style = "display: none;"> DIV 2 </div> 

< input id = "buttonl" type = "button" onclick = "showAndHiddenl();" value = "DIV 切换 " /> 
<hr> 

<div> visibility: 元 素 占 用 页 面 位 置 </div> 

<div id- "div3" style= "visibility:visible;"» DIV 3</div> 

«div id= "div4" style- "visibility:hidden;"» DIV 4 </div> 

< input id = "button2" type = "button" onclick = "showAndHidden2();" value = "DIV 切换 ”/> 


</body> 
«/htnl > 


调用 API 的 实例 代码 : 


def test getWebElementIsDisplayed(self): 


url = "d:Wtest. html" 

# We EE X HIML 网 页 

self.driver.get(url) 

# 通过 id= "div2" 找 到 第 二 个 div JUXK 

div2 = self.driver.find element by id("div2") 

# 判断 第 二 个 div 元 素 是 否 在 页 面 上 可 见 

print div2.is displayed() 

# li^ 4 Uf& div ffl, HRP div 显示 在 页 面 上 
self.driver.find element by id("buttonl").click() 

# BRACHIA P div jus Je is n] A 

print div2.is displayed() 

# 通过 id= "diva" JE S AB [I f- div TŽ 

div4 - self.driver.find element by id("div4") 

5 判断 第 四 个 div 元素 是 否 在 页 面 上 可 见 

print div4.is displayed() 

BOB Ld Ui div fkth, HRING div 显示 在 页 面 上 
self.driver.find element by id("button2").click() 

# 再 次 判断 第 四 个 div GREB n 

print div4. is displayed() 
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更 多 说 明 : 
页 面 不 可 见 的 元 素 虽 不 在 页 面 上 显示 ,但 是 存在 于 DOM 树 中 ,这 些 元 素 WebDriver 也 
是 可 以 找到 的 。 


10.14 MEJE or RETE 


用 于 测试 的 HTML RE: 


<html> 
<head> 
«title» HTML 中 不 可 操作 元 素 </title> 
< meta http - equiv = "Content - Type" content = "text/html; charset = utf - 8" /> 
«/ head » 
<body> 
< input id = "inputl" type= "text" size= "40" value= "可 操作 " > 
<br /> 
< input id = "input2" type= "text" size = "40" value= "不 可 用 " disabled» 
<br /> 
< input id = "input3" type = "text" size = "40" value= "只 读 " readonly> 
</body> 
</html> 


调用 API 的 实例 代码 : 


def test getWebElementIsEnabled(self): 
url = "d:Wtest. html" 
# Wl ELE X HTML 网 页 
self.driver.get(url) 
# 通过 id 找到 第 一 个 input w 
inputl = self.driver.find element by id("input1") 
# 判断 第 一 个 input JiR e 7 PT PEE 
print inputl.is enabled() 
# 通过 id 找到 第 二 个 input T 
input2 = self.driver.find element by id("input2") 
# 判断 第 二 个 input JUI A THREE 
print input2.is enabled() 
# 通过 id 找到 第 三 个 input JUX 
input3 = self.driver.find element by id("input3") 
# 判断 第 三 个 input RAA RME 
print input3. is_enabled( ) 


输出 结果 : 


True 
False 
True 


更 多 说 明 : 
从 执行 结果 可 看 出 ,对 元 素 添加 disabled 属性 以 后 ,元 素 将 会 处 于 不 可 操作 状态 。 


"Ya 
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o 
10.155 获取 页 面 元 素 的 属性 


用 于 测试 的 网 址 : 
http://www. sogou. com 
调用 API 的 实例 代码 : 


def test getWebElementAttribute(self): 
url = "http://www. sogou. com" 
# 访问 sogou Pf Jit 
self.driver.get(url) 
# OUI SC A EIC 
searchBox = self.driver.find element by id("query") 
# KRUR MAHET ICZ HY name Jai PE fii 
print searchBox.get attribute("name") 
Aqu fU edi A Fer dii AOL CT EET EA NE" IE 
searchBox. send keys(u" 测试 工程 师 指定 的 输入 内 容 ") 
EO IB UE EM) value Ju tE fii (EMER A HER XCE AL) 


print searchBox.get attribute(" value") 


10.16 PER TUPE :NYE 


用 于 测试 的 网 址 : 


http://www. baidu. com 
调用 API 的 实例 代码 : 


def test getWebElementCssValue(self): 
url = "http://www. baidu. com" 
# 访问 百度 首页 
self.driver.get(url) 
# EEIESES A EUR 
searchBox = self.driver.find element by id("kw") 
# 信用 页 面 元 素 对 和 象 的 value of css_property() 方 法 获取 元 素 的 CSS JR YE fit 
print u" 搜 索 输 入 框 的 高 度 是 : " ，searchBox. value_of css property("height" ) 
print u" 搜 索 输 入 框 的 宽度 是 : ", searchBox.value of _css_property("width" ) 
font = searchBox.value of css property("font - family") 
print u" 搜 索 输 入 框 的 字体 是 : "，font 
# B ERIS el A EDU E IKE IE arial fk 


self.assertEqual(font, "arial") 
10.17 EON ES 


用 于 测试 的 网 址 : 


http://www. baidu. com 
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调用 API 的 实例 代码 : 


def test_clearInputBoxText(self) : 
url = "http://www. baidu. com" 
# 访问 百度 网 页 
self.driver.get(url) 
# CHUA ffe o X 
input = self.driver.find element by id("kw") 
input.send keys(u" 光 荣 之 路 自动 化 测试 ”) 
import time 
time. sleep(3) 
# HR AEP PRANE 
input. clear() 
# EIES B, ERA IB TS i A HEWES WRR 
time. sleep(3) 


更 多 说 明 

在 测试 代码 中 直接 导入 需要 的 time fü import time) ,是 为 了 更 清晰 地 说 明 测 试 脚本 中 
的 代码 具体 来 自 哪 个 Python 包 , 以 后 的 代码 中 也 采用 此 种 方法 ,读者 可 以 将 导 包 代码 放 到 
脚本 文件 的 最 顶端 ,方便 管理 。 


10.18 MESES 





匡 中 输入 指定 内 容 


被 测试 网 页 的 HTML 代码 : 


<html> 
< body» 
< input type = "text" id= "text" value = "文本 框 默认 内 容 "> 文 本 框 </input > 
</body> 
</html > 


调用 API 的 实例 代码 : 


def test_sendTextToInputBoxText(self) : 
url = "d:\\test.html" 
* 访问 月 定义 的 HTML 网 页 
self.driver.get(url) 
# OEHUR A iE CBE AR 
input - self.driver.find element by id("text") 
5E ERR A TEE PRUNE 
input.clear() 
input. send keys(u" 我 是 输入 的 文本 内 容 ") 
Z FA time fg 
import time 
EOM 3E, E XUI TS AHE N E S MAR 
time. sleep(3) 


更 多 说 明 : 
在 真正 的 自动 化 测试 过 程 中 ,通过 WebDriver 脚本 向 网 页 上 的 输入 框 中 输入 中 文字 符 
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时 ,需要 将 中 文字 符 定义 成 utf-8 编码 的 字符 串 , 在 Python 中 就 是 在 中 文字 符 串 前 面 加 一 
个 字母 u 即 可 ,否则 会 报 UnicodeDecodeError: 'utf8' codec can't decode byte 0xe6 in 


position 0; unexpected end of data 异常 。 


10.19 MER: 


目的 : 
模拟 鼠标 左 键 单 击 操作 。 
被 测试 网 页 的 HTML 代码 : 


<html> 

<body> 
< input type = "text" id = "text" value = "文本 框 默认 内 容 "> 文 本 框 </input > 
< input type = "button" id - "button" value = "改变 文本 框 的 文字 " 
onClick = document. getElementById( "text"). value = "改变 了 !"></input > 

«/ body > 

«/htnl > 


调用 API 的 实例 代码 : 


def test_clickButton( self) : 
url = "d:\\test. html" 
# 访问 自 定 义 的 HTML 网 页 
self.driver.get(url) 
# Ee lvi xp e 
button - self.driver.find element by id("button") 
# 模拟 鼠标 左 键 单 击 操作 
button. click() 
import time 
time. sleep(3) 


ES 


目的 : 
模拟 鼠标 左 键 双击 操作 。 
被 测试 网 页 的 HTML 代码 : 
<html> 
<body> 
< input id = 'inputBox' type = "text" 
ondblclick = "javascript: this. style. background = 'red'"> 请 双击 </> 


</body> 
«/htnl > 


调用 API 的 实例 代码 : 


def test doubleClick(self): 
url = "d:Wtest. html" 


s $305 
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# 芒 问 请 定义 的 HTML 网 页 

self.driver.get(url) 

# EHOU IB fi A JUR 

inputBox = self.driver.find element by id("inputBox") 
# 时 人 支 桂 双击 操作 的 模块 

from selenium. webdriver import ActionChains 

E IF BEM BUR GE E FE 

action chains = ActionChains(self.driver) 
action chains.double click(inputBox).perform() 
import time 

time. sleep(3) 


执行 后 双击 input 框 ,背景 颜色 将 变 为 红色 。 

更 多 说 明 : 

selenium. webdriver. ActionChains 包 是 WebDriver 针对 Python 语言 提供 的 专门 用 于 
模拟 鼠标 操作 事件 的 包 ,比如 双击 、 甚 浮 、 拖 搜 等 ,这 些 在 后 面 都 会 陆续 介绍 。 





10.21 EE IE E 


被 测试 网 页 的 HTML 代码 : 


<html> 
<body> 
<select name = 'fruit' size= 1> 
<option id= 'peach' value = 'taozi'> 桃 子 </option> 
<option id= 'watermelon' value = 'xigua'> 西 瓜 </option > 






orange' value = ' juzi' selected = "selected"> 橘 子 </option> 
wifruit' value = 'mihoutao'»jj fx BEC/option» 


<option id 
<option id 





<option i naybush' value = ' shanzha'> 山 植 </option> 
«option id= 'litchi' value = '1izhi'> 荔 枝 </option> 
</select> 
</body > 
</html > 


10.21.1 遍历 所 有 选项 并 打印 选项 显示 的 文本 和 选项 值 
Python 语言 实例 代码 : 





def test printSelectText(self): 
url = "d:Wselect. html" 
# Wil Epig X ÁY HTML 网 页 
self.driver.get(url) 
# 使 用 nane [a PER SI Vt H E name 属性 为 "fruit" 的 下 苍 列 表 元 素 
select = self.driver.find element by name("fruit") 
all options = select. find elements by tag nane("option") 
for option inall options: 
print "选项 显示 的 文本 : ", option. text 
print "选项 值 为 : "，option. get_attribute("value" ) 
option.click() 
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import time 
time. sleep(1) 


输出 结果 : 


选项 显示 的 文本 : 桃子 
选项 值 为 : taozi 
选项 显示 的 文本 : 西瓜 
选项 值 为 : xigua 
选项 显示 的 文本 : 橘子 
选项 值 为 : juzi 

选项 显示 的 文本 : 猕猴 桃 
选项 值 为 : mihoutao 
选项 显示 的 文本 : 山楂 
选项 值 为 : shanzha 
选项 显示 的 文本 : 荔枝 
选项 值 为 : lizhi 


10.21.2 选择 下 拉 列 表 元 素 的 三 种 方法 
Python 语言 实例 代码 : 





def test operateDropList(self): 
url = "d:Wselect. html" 
# 访问 月 定义 的 HTML 网 页 
self.driver.get(url) 
# FA Select 模块 
from selenium. webdriver. support.ui import Select 
# 使用 xpath 定位 方式 获取 select 页 面 元 素 对 条 
select element - Select(self.driver.find element by xpath("//select")) 
# 打印 默认 选 由 项 的 文 杰 
print select element.first selected option.text 
# 获取 所 有 选择 项 的 页 面 元 素 对 条 
all options = select_element.options 
# 打印 选项 总 个 数 
print len(all options) 
is enabled(): 判断 元 素 是 否 可 操作 
is selected(): 判断 元 素 是 否 被 选中 


if all options[1].is enabled() and not all options[1].is selected(): 
# 方法 一 : WAF GAERNE IFEMOJFG 
select element.select by index(1) 


# 打印 已 选中 项 的 文本 
print select element.all selected options[0].text 
# assertEqual() 方 法 断言 当前 选中 的 选项 文本 是 否 是 "西瓜 
self.assertEqual(select element.all selected options[0]. text, u" 西 瓜 ") 
import time 
time. sleep(2) 
# 方法 二 : 通过 选项 的 显示 文本 选择 文本 为 " 狼 猴 桃 " 选 项 
select element.select by visible text(" 猕 猴 桃 ") 


“= 
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self.assertEqual(select element.all selected options[0].text, u" BIRK" ) 
time. sleep(2) 

# 方法 三 : 通 寻 选项 的 value JA HEFE value= "shanzha"jtJli 

select element.select by value("shanzha") 

print select element.all selected options[0].text 
self.assertEqual(select element.all selected options[0].text, u" WH" ) 


更 多 说 明 : 

select element. all. selected options 属性 获取 的 是 所 有 被 选中 项 的 对 象 组 成 的 列表 对 
象 ,由 于 本 实例 中 是 单 选 下 拉 列 表 , 因 此 选中 项 只 有 一 个 ,通过 select_element. all. selected | 
options[0]. text 这 句 代码 获取 被 选中 项 的 文本 内 容 。 


10.22 MU SEE PEE "351-1 


目的 : 

判断 单 选 列表 内 容 是 否 与 预期 内 容 一 致 。 
用 于 测试 的 HTML 代码 : 

被 测试 的 HTML 代码 同 10. 21 节 。 
Python 语言 实例 代码 : 


def test checkSelectText(self): 
url = "d: Wselect. html" 
# We EE XU HTML 网 页 
self.driver.get(url) 
# FA Select 模块 
from selenium. webdriver. support. ui import Select 
# 使用 xpath 定位 方式 获取 select 页 面 元 素 对 条 
select element - Select(self.driver.find element by xpath("//select")) 
# 获取 所 有 选择 项 的 页 面 元 业 对 和 象 
actual options = select element.options 
# 声明 一 个 list HR, felit FRIR PIR HUE XCE VERE 
expect optionsList = [u"BE-F",u" 西瓜",u" 橘 子 ",u" 猕 猴 桃 ",u" 山 植 ", 33€] 
# EHH Python py Bf map() 邱 数 获 了 肥 页 面 中 下 拉 列 表 展 示 的 选项 内 容 组 成 的 列表 对 象 
actual optionsList = map(lambda option: option.text, actual options) 
# 肠 言 甚 望 列表 对 和 象 和 实际 列表 对 和 象 是 否 完全 一 臻 
self.assertListEqual(expect optionsList, actual optionsList) 





10.28 HES: EIE 


用 于 测试 的 HTML RE: 


<html> 
< body> 
<select name= 'fruit' size = 6 multiple = true» 
<option id= 'peach' value = 'taozi'> 桃 子 </option> 
<option id= 'watermelon' value = 'xigua'> 西 瓜 </option > 
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«option id= 'orange' value = ' juzi'»fl f-«/option» 
«option id= 'kiwifruit' value = 'nihoutao'^ 944 BE«/ option? 
<option id= 'maybush' value = 'shanzha'> 山 楂 </option> 
«option id= 'litchi' value = 'lizhi'23$ Fr«/option? 
</select> 

</body> 

</htm] > 

Python 语言 实例 代码 : 


def test operateMultipleOptionDropList(self): 
url = "d:Wselect. html" 
* 访问 月 定义 的 HTML 网 页 
self.driver.get(url) 
# FA Select 模块 
from selenium. webdriver. support. ui import Select 
import time 
# IEJ xpath XE fv Jr 3C4EJK select HMI XE 
select element - Select(self.driver.find element by xpath("//select")) 
# 通过 序号 选 坚 第 一 个 元 素 
select element.select by index(0) 
# 通过 选项 的 文 二 选 树 "山本 "选项 
select element.select by visible text(" 山 楂 ") 
# 通过 选项 的 value [I Efl it E value = "mihoutao" 的 选项 
select element.select by value("mihoutao") 
# 打印 所 有 的 选中 项 文本 
for option in select element.all selected options: 
print option. text 
# 有 取消 所 有 已 选中 项 
select element.deselect all() 
tine. sleep(2) 
print" ----------- 再 次 选中 3 个 选项 -------------- $ 
select_element. select_by_index(1) 
select_element. select_by_visible_text(" #4") 
select element.select by value(" juzi" ) 
lb sd EXC BG E Ver M XC 26 "HEC 
select element.deselect by visible text(" 3$ #t" ) 
EU EMG Pim so ign 
select element.deselect by index(1) 
# 通过 选项 的 value B TE (fi HU CL 3E P Hf value = "juzi" 的 选项 


select element.deselect by value(" juzi") 


10.24 芷 可 以 输入 的 下 拉 列 表 ( 输 入 的 同时 模拟 按键 ) 





目的 : 
实现 输入 的 同时 模拟 按键 操作 。 
用 于 测试 的 HTML 代码 : 


<html> 
<body> 
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<div style = "position:relative;"» 
< input list = "pasta" id= "select"» 
«datalist id= "pasta"» 
< option» Bavette </option > 
< option» Rigatoni </option> 
< option» Fiorentine </option> 
< option > Gnocchi </option > 
<option > Tagliatelle </option> 
X option > Penne lisce </option > 
< option» Pici «/option» 
< option» Pappardelle «/option» 
< option > Spaghetti </option> 
< option» Cannelloni </option> 
< option? Cancl </option > 
«/datalist» 
</div> 
</body> 
</html> 


调用 API 的 实例 代码 : 


def test operateMultipleOptionDropList(self): 
url = r"D:Vdata. html" 
* 访问 自 定义 的 HTML 网 页 
self.driver.get(url) 





from selenium. webdriver.common.keys import Keys 

self.driver.find element by id("select").clear() 

import time 

time. sleep(1) 

# 输 人 的 同时 按 下 航 头 键 

self.driver.find element by id("select").send keys("c", Keys. ARROW DOWN) 
self.driver.find element by id("select").send keys(Keys. ARROW DOWN) 
self.driver.find element by id("select").send keys(Keys.ENTER) 

time. sleep(3) 


更 多 说 明 : 

运行 这 段 测试 代码 可 以 看 到 输入 字符 “c” 的 同时 看 到 筛选 出 的 数据 项 中 第 一 项 被 选中 。 
但 在 某 些 浏览 器 的 某 些 版 本 效果 会 不 明显 。 除 了 下 箭头 ,Keys 模块 还 提供 了 很 多 其 他 的 模 
拟 按键 ,后 面 会 继续 介绍 一 部 分 ,读者 也 可 以 通过 dirO 函数 查看 。 





用 于 测试 的 HTML 代码 : 


<html > 
<body> 
«form? 
< input type = "radio" name = "fruit" value = "berry" /> 草莓 </input> 
<br /> 
< input type = "radio" name = "fruit" value= "watermelon" /> 西瓜 </input > 
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<br /> 
< input type = "radio" name = "fruit" value= "orange" /2 橙子 </input > 
</form> 
</body > 
</html > 


调用 API 实例 代码 : 


def test operateRadio(self): 
url = "d: W radio. html" 
# 访问 月 定义 的 HTML 网 页 
self.driver.get(url) 
* [EJ] xpath xE f 3E value [a FE ffi Jj 'berry' fff] input TEIS S, UL BE 4E " HE RE" EE 
berryRadio = self.driver.find element by xpath("//input[(2 value = 'berry']") 
# ili it PE" TE REO 
berryRadio.click() 
# NECI I E BER D n 
self.assertTrue(berryRadio. is_selected()，u" 草 莓 单 选 框 未 被 选中 !" ) 
if berryRadio. is_selected() : 
# 如 时 " 章 蕉 " 单 选 碟 设 成 功 选中 ,重新 选择 "西瓜 "选项 
watermelonRadio = self. driver. find element by xpath("//input[(Zvalue- 'watermelon']") 
watermelonRadio.click() 
# DEFE" VU" VEDI DUI, Bo a CREE DIAE EA EVE PARE 
self.assertFalse(berryRadio. is selected()) 
* rtr fi nane [FE (fL Jy " Eruit "fg EMERI R, JE TEE fe radioList 列表 中 
radioList = self.driver.find elements by xpath("//input[(2name = 'fruit']") 
循环 遍历 radioList 中 的 每 个 单 选 按钮 ,查找 value 属性 值 为 "orange" 的 单 选 框 ， 
如 果 找 到 此 单 选 框 以 后 , 发 现 未 处 于 选中 状态 , 则 调用 click 方法 选中 该 选项 . 


for radio in radioList: 
if radio.get attribute("value") == "orange": 
if not radio. is selected(): 
radio. click() 
self.assertEqual(radio.get attribute("value"), "orange") 





10.26 MEI p bui 


用 于 测试 的 HTML 代码 : 


<html > 
<body> 
< form name = 'forml'> 
< input type = "checkbox" name = "fruit" value = "berry" /> 草莓 </input > 


<br /> 
< input type = "checkbox" name = "fruit" value = "watermelon" /> 西瓜 </input > 
<br /> 
< input type = "checkbox" name = "fruit" value = "orange" /> 橙子 </ input > 
</form> 
</body> 
</html > 
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调用 API 的 实例 代码 : 


def test_operateCheckBox( self) : 

url = "d:\NCheckBox.htmln" 
# Ue FLEX HTML 网 页 
self.driver.get(url) 
* IEM xpath xE fe Et value Jai FE [fi Jj 'berry' llf] input TEIR, UL BE JE " HERE" EE 
berryCheckBox = self.driver.find element by xpath("//input[(4 value = 'berry']") 
# quit EU REUEE 
berryCheckBox. click() 
MBE "TARE " RE E HE BE DI enn 
self.assertTrue(berryCheckBox. is selected(), u" 草 医 复 选 框 未 被 选中 !") 
if berryCheckBox. is selected(): 

# OUR "TE RE " AE VE HE BEI D Ve rh, BEC di b t P 

berryCheckBox. click() 

ONERE AE VE HE AT S 

self.assertFalse(berryCheckBox.is selected()) 
* ARA nane [HE (Hi Jy "Fruit" hy E vb E 63 X1 4, JE E C fe checkBoxList 列表 中 
checkBoxList = self.driver.find elements by xpath("//input[(Zname = 'fruit']") 
# 遍历 checkBoxList 7| Ze (f 109 Pr fi 1 ve fle j6 3, 1 WU Aa VE fie Ab T EVE PRE 
for box in checkBoxList: 

if not box. is selected(): 

box. click() 


10.27 Wi: i 关键 字 





目的 : 
确定 所 加 载 的 页 面 是 否 出 现 了 预期 内 容 。 
用 于 测试 的 网 址 : 


http://www. baidu. com 
Python 语言 实例 代码 : 


def test_assertKeyWord( self) : 
url = "http://www. baidu. com" 
# 访问 百度 首页 
self.driver.get(url) 
self.driver.find element by id("kw"). send keys(w 光 荣 之 路 自动 化 测试 ") 
self.driver.find element by id("su").click() 
import tine 
time. sleep(4) 
EOGBGREISI Fi D IH Ae A FE e ACIES IE FARE UG XE VU IBI c BR T H ILC 
assert u" 首页 -- 光荣 之 路 ”in self.driver.page source, u" 页 面 源码 中 不 存在 该 关键 字 !" 


有 时 会 出 现 页 面 存 在 要 断言 的 内 容 , 但 结果 仍 断 言 失败 ,这 可 能 是 由 于 页 
面 还 未 加 载 完 全 就 开始 执行 断言 语句 ,导致 要 断言 的 内 容 在 页 面 源 码 中 找 
不 到 。 
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10.28 oD 


I5 


用 于 测试 网 址 : 


http://www. sogou. com 


调用 API 的 实例 代码 : 


def test captureScreenInCurrentWindow( self): 
url = "http://www. sogou. com" 
# 访问 搜狗 首页 
self.driver.get(url) 
try: 


调用 get screenshot as file(filename) 方 法 ,对 浏览 器 当前 打开 页 面 
进行 截图 ,并 保 为 C 盘 下 的 screenPicture. png 文件 


result = self.driver.get screenshot as file(r"c:\screenPicture.png") 
print result 

except IOError, e: 
print e 


更 多 说 明 
CD 调用 截屏 函数 get. screenshot as _file() 截 图 成 功 后 会 返回 True. 如果 发 生 了 
IOError 异常 ,会 返回 False。 函 数 中 传递 的 存放 图 片 的 路 径 可 以 是 绝对 路 径 , 也 可 以 是 相 


对 路 径 。 
(2) 当 自动 化 测试 过 程 中 ,未 实现 预期 结果 ,可 以 将 页 面 截图 保存 ,方便 更 快速 地 定位 
问题 。 
10.29 Bio puni 
用 于 测试 的 网 址 : 


http://jqueryui. com/resources/demos/draggable/scroll.html 
调用 API 的 实例 代码 : 


def test dragPageElement(self): 
url = "http://jqueryui. com/resources/demos/draggable/scroll.html" 
zog gta FA T 
self.driver.get(url) 
# KR E R — A BETR TRI VCI IURE 
initialPosition - self.driver.find element by id("draggable") 
# NOU EB T BETRTEIU VII DUE 
targetPosition - self.driver.find element by id("draggable2") 
# NOI ER =A RE tete h T IR 
dragElement = self. driver. find element by id("draggable3") 
# FAHM HIIR I AMR ActionChains 
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from selenium. webdriver import ActionChains 
import time 


创建 一 个 新 的 ActionChains, 将 webdriver 实例 对 象 driver 作为 参数 值 传 入 
然后 通过 WebDriver 实例 执行 用 户 动作 . 


action chains = ActionChains(self. driver) 

# HK Ul ES BEBE TUM CREE TERRE LE ILE 

action chains.drag and drop(initialPosition, targetPosition).perform() 

EOM EST BETR TEI TCR, it Fiz 10 RR, JT RI 5 Xx 

for i in xrange(5): 
action chains.drag and drop by offset(dragElement, 10, 10).perform() 
time.sleep(2) 


10.30 REVE: Sit Ea t 1i 


用 于 测试 的 网 址 : 
http://www. sogou. com 


调用 API 的 实例 代码 : 


def test simulateASingleKeys(self): 
url = "http://www. sogou. com" 
* WHO ER, fln ee ELSE Dr TII dedi A icr 
self.driver.get(url) 
EOS BHIUTERE BER Keys 
from selenium. webdriver. common. keys import Keys 
import time 
# 通过 id KRIL edi A MED DT JER 
query = self.driver.find element by id("query") 
# 通过 WebDriver 实例 发 送 一 个 F12 f 
query. send keys(Keys. F12) 
time. sleep(3) 
# 再 次 通过 WebDriver 实例 模拟 发 送 一 个 F12 faf 
query. send keys(Keys. F12) 
# FETU A fie rl A "selenium" 
query. send keys(" selenium" ) 
# 通过 WebDriver KARME iX — f el E fb, 
# 或 者 信用 query. send keys(Keys. RETURN) 
query. send keys(Keys. ENTER) 
time.sleep(3) 


说 明 : 

本 实例 推荐 在 TE 浏览 器 上 测试 ,其 他 浏览 器 部 分 版 本 可 能 看 不 到 效果 。 部 分 电脑 的 功 
能 键 可 能 需要 同时 按 下 Fn 键 才能 生效 ,比如 Fn + F12 组 合 键 。 

更 多 说 明 : 

在 本 章 的 10. 19 节 中 ,讲解 的 是 在 输入 操作 的 同时 模拟 一 个 键盘 按键 ,而 本 节 讲 的 是 : 
在 其 他 页 面 动作 完成 后 再 进行 键盘 按键 模拟 操作 。 这 两 种 情况 下 的 按键 都 只 能 针对 单个 按 
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键 ,并 且 是 按 下 马上 松 开 按键 。Keys 模块 还 提供 了 一 部 分 其 他 键 可 以 模拟 ,请 读者 根据 自 
己 需要 进行 练习 使 用 。 


10.31 REEE s liz 


环境 准备 : 

访问 http://sourceforge. net/projects/pywin32/files/pywin32/Build%20219/ 网 站 ,下 
载 支持 Python 模拟 Windows 组 合 按键 的 pywin 安装 包 。 读 者 必须 根据 自己 Python 的 位 
数 (64 位 或 32 位 ) 选 择 相应 位 数 的 安装 包 , 和 否则 安装 会 报错 ,安装 方法 同 Windows 应 用 程 
序 一 致 ,安装 过 程 中 无 须 做 任何 更 改 。 

安装 完成 后 ,在 Python 交换 模式 下 执行 如 下 两 句 代 码 : 


import win32clipboard as w 
import win32con 


如 果 没 报错 ,说 明 安 装 成 功 。 
10.31.1 通过 WebDriver 内 建 的 模块 模拟 组 合 键 
目的 : 
通过 模拟 按键 实现 全 选 . 剪 切 以 及 粘贴 操作 。 
用 于 测试 的 网 址 : 
http://www. baidu. com 
Python 语言 实例 代码 : 


# FARMA S ERE E GL 
from selenium. webdriver import ActionChains 





from selenium. webdriver. common. keys import Keys 
import time 


以 上 代码 放 到 单元 测试 类 外 边区 域 。 测 试用 例 方法 如 下 : 


def test sinulationCombinationKeys(self): 
url = "http://www. baidu. com" 
# 访问 百度 首页 
self.driver.get(url) 
eO Hos UH SITE dg A fie 
input = self. driver. find element by id("kw") 
input.click() 
input. send keys(u" 3E 9& Z 8" ) 
time. sleep(2) 
ActionChains(self.driver).key down(Keys.CONTROL). send keys('a').N 
key up(Keys. CONTROL) . perforn() 
time. sleep(2) 
ActionChains(self.driver).key down(Keys. CONTROL). send keys('x').V 
key up(Keys. CONTROL). perform() 
self.driver.get(url) 
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self.driver.find element by id("kw").click() 

* 模拟 Ctrl + VAR RE, TEM DERE H PIIRE BS ALERT edi A HEP 
ActionChains(self.driver).key down(Keys.CONTROL).send keys('v').V 
key up(Keys. CONTROL) . perforn() 

zonu"WnE— F'gsiiu 

self.driver.find element by id('su').click() 

time.sleep(3) 


代码 解释 : 

ActionChains(self. driver). key down( Keys. CONTROL). send_keys('v'). key. up 
(Keys. CONTROL). perform ix FARI rP. key downC Keys. CONTROL) Xo fk F Ctrl 
键 ,send_keys('v') 类 似 模 拟 了 V 键 ,组 合 起 来 就 是 Ctrl 十 V 组 合 键 ,而 key upCKeys. 
CONTROL) KIR FE Ctrl 键 。 

更 多 说 明 : 

Selenium 3. x 的 ActionChains 模块 在 某 些 类 型 的 浏览 器 的 某 些 版 本 中 失效 或 不 稳定 ， 
比如 Firefox 49 版 本 ,这 可 能 是 Mozilla/geckodriver 驱动 的 一 个 bug ,如果 读 者 确实 想 在 
Firefox 浏览 器 上 完成 按键 模拟 ,请 考虑 使 用 Selenium 2, 

本 实例 代码 笔者 在 Chrome 53. 0.2785. 143 (正式 版 本 ) m(32 位 ) 版 本 的 浏览 器 上 实验 
成 功 , 并 能 稳定 运行 。 通 过 上 面 实 例 的 方法 可 以 模拟 更 多 的 组 合 按键 ,请 读者 自行 模拟 
练习 。 


后 续 所 有 涉及 ActionChains 模块 的 实例 代码 默认 均 使 用 Chrome 浏览 器 。 





10.31.2 ”通过 第 三 方 模块 模拟 组 合 按键 


目的 : 
通过 模拟 按键 实现 全 选 、 剪 切 、 粘 贴 以 及 回 车 键 操作 。 
用 于 测试 网 址 : 


http://www. baidu. com 
http://www. sogou. com 


Python 语言 实例 代码 : 


EOS ABEHUI S fe fs ELM GL 
import win32api 

import win32con 

import tine 





VK CODE ={ 
'enter' :0x0D, 
'ctrl':0x11, 
'a':0x41, 
'v':0x56, 

'x' :0x58 
} 
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# fE ETE F 
def keyDown(keyName) : 
win32api.keybd event(VK CODE[keyName], 0, 0, 0) 
ZH AERE 
def keyUp(keyNane) : 
win32api.keybd event(VK CODE[keyName], 0, win32con.KEYEVENTF KEYUP, 0) 


上 面 这 段 代码 中 ,提供 了 模拟 按键 所 需要 导入 的 包 , 键 盘 键 对 应 的 命令 以 及 完成 按 下 键 
与 抬 起 键 动作 方法 , 放 到 测试 类 外 面 。 测 试用 例 方法 如 下 : 


def test simulationCombinationKeys( self): 
url = "http://www. sogou. com" 
# BTE PEE 
self.driver.get(url) 
* RUBIA A EIC 
searchBox - self.driver.find element by id("query") 
# oa HABI R dg A fie p 
searchBox. click() 
# URMA PRA "ERZ EE A zei" 
searchBox. send keys(u" 光 荣 之 路 自动 化 测试 ") 
# OBUSISJLER, Dy IK Piin 
time. sleep(3) 
# 模拟 Ctrl + A, Er dg A fie rh IPEA EE 
keyDown( 'Ctrl') 


keyDown( 'A' ) 
# RE Ctrl + AHA 
keyUp( 'A') 


keyUp( 'Ctr1') 

# 模拟 Ctrl + x DUA PA E 
keyDown( 'Ctrl') 

keyDown( 'X' ) 

keyUp('X') 

keyUp( 'Ctr1') 

# 访问 百度 首页 

self. driver. get("http: //www. baidu. com") 
EOM REER AHER 
self.driver.find element by id("kw").click() 
# BH Ctrl + Vi Gb, VETE 
keyDown(" Ctr1") 

keyDown(" V" ) 

keyUp('V') 

keyUp( 'Ctrl') 

# BMA 

keyDown( 'enter') 

keyUp( 'enter') 

time.sleep(5) 


更 多 说 明 : 
上 面 实例 代码 中 模拟 键盘 按键 是 通过 将 Windows 键 名 与 Windows 命令 一 一 映射 来 实 
现 的 ,更 多 的 按键 命令 映射 如 下 : 
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# 键 盘 上 所 有 键 的 映射 
VK CODE = ( 


'backspace' :0x08, 
'tab':0x09, 
'clear':0x0C, 
'enter':0x0D, 
'shift':0x10, 
'ctrl':0x11, 
'alt':0x12, 
'pause' : 0x13, 
'caps lock':0x14, 
'esc' :Ox1B, 
'spacebar' :0x20, 
'page up':0Ox21, 
'page down':0x22, 
'end':0x23, 
"home' : 0x24, 
'left arrow':0x25, 
'up arrow' :0x26, 
'right arrow':0x27, 
'down arrow':0x28, 
'select':0x29, 
'print':0x2A, 
'execute' :0x2B, 
'print screen':0x2C, 
'ins' :0x2D, 
'del':0x2E, 
'help':Ox2F, 
'0':0x30, 
*1*:0x31; 
'2':0x32, 
'3':0x33, 
'4':0x34, 
'5':0x35, 
'6':0x36, 
'7:0x37, 
'8':0x38, 
'9':0x39, 
'a':0x41, 
'b':0x42, 
Cc':0x43, 
'd':0x44, 
'e':0x45, 
'£':0x46, 
g':0x47, 
'h':0x48, 
'i':0x49, 
j':0x4A, 

'k' :0x4B, 
*1*:0x4C, 
'm':0x4D, 
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'n' :Ox4E, 

'o' :Ox4F, 

'p':0x50, 
'q':0x51, 

r':0x52, 

's':0x53, 

'£' :0x54, 

'u':0x55, 

'v':0x56, 

'w':0x57, 

"x! :0x58, 

'y':0x59, 

'z':0x5A, 
'numpad 0':0x60, 
'numpad 1':0x61, 
'numpad 2':0x62, 
'numpad 3':0x63, 
'numpad 4':0x64, 
'numpad 5':0x65, 
'numpad 6':0x66, 
'nunpad 7':0x67, 
'numpad 8':0x68, 
'numpad 9':0x69, 
"multiply key':0x6A, 
'add key' :0x6B, 
'separator key':0x6C, 
'subtract key':0x6D, 
'decimal key':0x6E, 
"divide key':0x6F, 
"F1':0x70, 

'F2' :0x71, 

'F3' :0x72, 

'F4' :0x73, 

"ES! 20x74, 

'F6' :0x75, 

"ET :0x76, 

"F8 :0x77, 

'F9' :0x78, 
'F10':0x79, 
'F11':0x7A, 
'F12':0x7B, 
*F13':0x7C, 

"F14' :0x7D, 
"F15':0x7E, 
"F16':0x7F, 
'F17':0x80, 
"F18':0x81, 
*F19':0x82, 
*F20':0x83, 
*F21':0x84, 


* MA * 


'F22':0x85, 

'F23':0x86, 

'F24':0x87, 

'num lock':0x90, 

'scroll lock':0x91, 

'left shift':0xA0, 

'right shift ':0xAl, 
'left control':0xA2, 
'right control':0xA3, 
'left menu':0xA4, 

'right menu':0xA5, 
'browser back':0xA6, 
'browser forward':0xA7, 
'browser refresh':0xA8, 
'browser stop':0xA9, 
'browser search':0xAA, 
'browser favorites' :0xAB, 
'browser start and home':0xAC, 
'volume mute' :0xAD, 
'volume Down':OxAE, 
'volume up':OxAF, 

'next track':0xB0, 
'previous track':0xBl, 
"stop media':0xB2, 
'play/pause media' :0xB3, 
'start mail':0xB4, 
'select media' :0xB5, 
'start application 1' :0xB6, 
'start application 2':0xB7, 
'attn key' :0xF6, 

'crsel key' :OxF7, 

'exsel key':OxF8, 

'play key' :OxFA, 

'zoom key' :0xFB, 

'clear key' :OxFE, 

' + ':0xBB, 

', ':0xBC, 

! — ':0xBD, 








'[':0xDB, 
"\\':0xDC, 
']':0xDD, 





" :0xDE, 
™' :0xC0 
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10.31.3 ”通过 设置 剪贴 板 实现 复制 和 粘贴 





目的 : 

通过 按键 实现 复制 粘贴 操作 。 
用 于 测试 的 网 址 : 

http://www. baidu. com 

Python 语言 实例 代码 : 


# SA EU E ERES SERO Fu 

from selenium. webdriver import ActionChains 
from selenium. webdriver. common. keys import Keys 
import win32clipboard as w 

import win32con 

import time 


# BUR fR 
def getText(): 
w. OpenClipboard() 
d = w.GetClipboardData(win32con.CF TEXT) 
w. CloseClipboard() 
return d 


# BNET 
def setText(aString): 
w. OpenClipboard() 
w. EnptyClipboard() 
w. SetClipboardData(win32con.CF UNICODETEXT, aString) 
w. CloseCl ipboard() 


以 上 代码 放 到 单元 测试 类 外 边区 域 。 测 试用 例 方法 如 下 : 


def test copyAndPaste(self): 
url = "http://www. baidu. com" 
# 访问 百度 首页 
self.driver.get(url) 
# EN ENHETER EE PEU ME BP D ALTRE 
content = u' 光 荣 之 路 ' 
# 将 content W rh fg p ZI BE] 9) Rs f P 
setText(content) 
# M REB D EROS PE EY DI RW Be P PARE 
getContent - getText() 
print getContent. decode(" gbk" ) . encode(" utf - 8") 
Eo UHR SIUE dei A fie 
self.driver.find element by id("kw").click() 
# BH Ctrl + VABE, TEM DIR PIR EIAS PIER IIO e fi A HEP 
ActionChains(self.driver).key down(Keys.CONTROL).send keys('v').V 
key up(Keys. CONTROL) . perform() 
# Mili" AE— Es 
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self. driver. find element by id('su').click() 
time. sleep(3) 


代码 解释 : 

通过 win32clipboard 和 win32con 包 实 现 将 数据 设置 到 剪贴 板 中 ; 通过 WebDriver 内 
建 的 ActionChains 和 Keys 模块 共同 实现 组 合 按键 的 操作 。 

ActionChains(self. driver). key down( Keys. CONTROL). send_keys('v'). key. up 
(Keys. CONTROL). perform 这 行 代码 中 ,key_down(Keys. CONTROL) 表示 按 下 Ctrl 
键 ,send_keys('v') 类 似 模 拟 了 V 键 , 组 合 起 来 就 是 Ctrl 十 V 组 合 键 ,而 key upCKeys. 
CONTROL) 表 示 释 放 Ctrl 键 。 

更 多 说 明 

上 面 实例 代码 其 实 是 将 WebDriver 内 建 的 模拟 按键 的 方法 与 第 三 方 提供 的 模拟 按键 
的 方法 结合 起 来 了 ,通过 这 种 方法 可 以 模拟 更 多 的 组 合 按键 功能 ,读者 可 以 根据 自己 的 需要 


进行 组 合 。 


10.32 M, E EP E EYE 





目的 : 
模拟 右键 菜单 实现 粘贴 效果 。 
用 于 测试 网 址 : 


http://www. sogou. com 


调用 API 的 实例 代码 : 
BOSA BIG Bel EO 


fron selenium. webdriver import ActionChains 
import win32clipboard as w 

import win32con 

import tine 


# BEDRAE 
def setText(aString): 
w. OpenClipboard() 
w. EnptyClipboard() 
w. SetClipboardData(win32con.CF UNICODETEXT, aString) 
w. CloseClipboard() 


将 上 面 这 段 代码 放 到 单元 测试 类 外 边 的 区 域 .测试 用 例 方法 代码 如 下 : 


def test rigthClickMouse(self): 
url = "http://www. sogou. com" 
# 访问 搜狗 首页 
self.driver.get(url) 
# EFIE i ATE 
searchBox = self.driver.find element by id("query") 
E FI a D Ha SIS Cl A fie 
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SearchBox.click() 

time. sleep(2) 

# ERRA HE EHRT — BUT ER tM 
ActionChains(self.driver).context click(searchBox).perform() 
# fi "gloryroad" $ 1g EE Pe 9l DI Wr fc vh, 8 FRIT T EHE 
setText(u'gloryroad') 

# RE—4M MOT, FIF PHE ER ERNE 
ActionChains(self. driver). send keys('P').perform() 

# Aliez H 

self. driver. find element by id('stb').click() 

time. sleep(2) 





目的 : 
在 灰色 的 div 区 域 , 模 拟 鼠 标 单 击 


,并 在 鼠标 左 键 按 下 和 释放 左 键 过 程 中 显示 一 些 特 定 





的 文字 。 
用 于 测试 的 HTML 代码 : 


<html> 
<head> 
<meta http- equiv = "Content - Type" content = "text/html; charset = utf - 8" /> 
< script type = "text/javascript"> 
function mouseDownFun( ) 
{ 
document. getElementById( 'div1'). innerHTML += 
' 鼠 标 左 键 被 按 下 < br/>'; 
} 
function nouseUpFun() 
{ 
document. getElementById( 'div1'). innerHTML += 
' 已 经 被 按 下 的 鼠标 左 键 被 释放 抬 起 <br/>'; 
} 
function clickFun() 
{ 
document. getElementById( 'div1'). innerHTML += 
' 单 击 动 作 发 生 <br/>'; 
} 
</script > 
</head> 
<body> 
<div id= "div1" onmousedown = "mouseDownFun() ;" onmouseup = "mouseUpFun();" 
onclick = "clickFun();" style = "background: # CCC; border:3px solid #999; 
width:200px; height:200px; padding :10px"> 
</div> 
< input style = "margin - top: 10px" type = "button" 
onclick = "document. getElementById('div1'). innerHTML = '';" value = "清除 信息 ”人 > 
</body> 
<html> 
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调用 API 的 实例 代码 : 


def test simulationLeftClickMouseOfProcess(self): 
url = "d: Wtest. html" 
# 芒 问 月 定义 的 HTML 网 页 
self.driver.get(url) 
div = self.driver.find element by id("divl") 
from selenium.webdriver import ActionChains 
import time 
# 在 id AEA "divi "hK ERITI FRIRE tE, HR TY 
ActionChains(self.driver).click and hold(div).perfornm() 
time. sleep(2) 
# dk id Atel A "divi" hg eR E EEIC— Erf F hy BU Ze f 
ActionChains(self.driver).release(div).perform() 
tine. sleep(2) 
ActionChains(self.driver).click and hold(div).perform() 
tine.sleep(2) 
ActionChains(self.driver).release(div).perform() 





目的 : 

在 网 页 上 的 链接 上 方 悬 浮 鼠 标 ,在 页 面 上 可 以 显示 出 一 个 蓝 色 的 长 方形 图 案 ,鼠标 离开 
链接 上 方 后 , 蓝 色 的 长 方形 图 案 消失 。 

用 于 测试 的 HTML 网 页 代码 : 


<html> 
< head > 


<meta http - equiv = "Content - Type" content = "text/html; charset = utf - 8" /> 





< script language = "javascript" 
function showNone( ) 
1 
document.getElementById('divl').style.display = "none"; 
} 
function showBlock()( 
document. getElementById('divl').style.display = "block"; 
) 
</script> 
< style type = "text/css"> 
#divi { 
position:absolute; 
width: 200PX; 
height:115px; 
z- index:1; 


left: 28px; 
top: 34px; 
background - color: # 0033CC; } 
</style> 
</head> 
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< body onload = "showNone( ) "> 
«div id= "divi"»«/div» 
<a onmouseover = "showBlock()" onmouseout = "showNone()" id = "link1"> 鼠 标 指 过 来 1 </a> 
<a onmouseover = " showBlock()" onmouseout = "showNone()" id = "1ink2"> 鼠 标 指 过 来 2 </a> 
<Pp> 鼠 标 悬 浮 这 里 的 时 候 , 蓝 色 的 图 形 框 就 消失 了 < p> 

</body> 

</html > 


调用 API 的 实例 代码 : 


def test_roverOnElement( self) : 
url = "d:Wtest. html" 
# 访问 月 定义 的 HTML 网 页 
self.driver.get(url) 
* 茂 到 页 面 上 第 一 个 链接 元 素 
linkl = self.driver.find element by _partial_link_text(u" 指 过 来 1") 
# 找到 页 面 上 第 二 个 链接 元 莱 
link2 = self.driver.find element by partial link text(u" 指 过 来 2") 
# ORBIS ED p oos 
p 7 self.driver.find element by xpath("//p") 
print linkl.text, link2.text 
# 导 人 需要 的 Python fg 
from selenium. webdriver import ActionChains 
import time 
SOMEBUIAKIESIT — HEBCU E 
ActionChains(self.driver).move to element(linkl).perform() 
time. sleep(2) 
OK BURMA — f EERCUSCEERISI p UE 
ActionChains(self.driver).move to element(p). perforn() 
time. sleep(2) 
BOMEBUIAKIESITE PERKE 
ActionChains(self.driver).move to element(link2).perform() 
time. sleep(2) 
OK BURMA LT ERCUXEESISI poU E 
ActionChains(self.driver).move to element(p).perforn() 
time. sleep(2) 


结果 说 明 

当 鼠 标 悬 浮 到 页 面 上 两 个 链接 上 时 ,页面 会 出 现 一 个 蓝 色 长 方形 图 案 , 当 将 鼠标 从 链接 
元 素 上 移动 到 p 元 素 上 时 , 蓝 色 长 方形 图 案 消 失 。 

更 多 说 明 : 

使 用 鼠标 悬浮 在 某 个 元 素 的 操作 可 以 完成 对 某 些 网 页 上 需要 用 鼠标 悬浮 后 才能 出 现 的 
页 面 元 素 的 操作 。 














10.35 MEI ope en 





用 于 测试 的 网 址 : 


http://www. sogou. com 
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调用 API 的 实例 代码 : 


def isElementPresent(self, by, value): 
# A selenium. common. exceptions $i t$ A NoSuchElementException 异常 类 
from selenium. common. exceptions import NoSuchElementException 
try: 
element - self.driver.find element(by - by, value - value) 
except NoSuchElementException, e: 
# 打印 异常 售 息 
print e 
# 发 生 卫 NoSuchElementException 5j, isi HJ] Tt Il] PRH Sl iE JC X, i8 [n] False 
return False 
else: 
# 没有 发 生 蜡 党 ,表示 在 页 面 由 茂 到 了 该 无 素 , 返回 True 


return True 


def test isElementPresent(self): 
url = "http://www. sogou. com" 
# 访问 sogou Pf Jit 
self.driver.get(url) 
# FIDIC id AHEM "query" IV) IEK AE fF E 
res = self. isElementPresent(" id", "query") 
if res is True: 
print u" 所 查找 的 元 素 存 在 于 页 面 上 !" 
else: 


print u" 页 面 中 未 找到 所 需要 的 页 面 元 素 !" 
代码 解释 : 


from selenium. common. exceptions import NoSuchElementException 表示 从 selenium. 
common. exceptions 这 个 异常 模块 导入 NoSuchElementException 异常 类 ,在 使 用 WebDriver 实 
施 自动 化 的 过 程 中 抛 出 的 所 有 异常 都 是 从 这 个 模块 导入 的 ,比如 TimeoutException 5$ 


常 等 。 


10.36 MICE:EZI 


隐 式 等 待 表示 在 自动 化 实施 过 程 中 ,为 查找 页 面 元 素 或 者 执行 命令 设置 一 个 最 长 等 待 
时 间 , 如 果 在 规定 时 间 内 页 面 元 素 被 找到 或 者 命令 被 执行 完成 , 则 执行 下 一 步 ,否则 继续 等 
待 直到 设置 的 最 长 等 待 时间 截 止 。 

用 于 测试 的 网 址 : 

http://www. sogou. com 

调用 API 的 实例 代码 : 

def test implictWait(self): 

# FARAZ 


from selenium. Common. exceptions import NoSuchElementException, TimeoutException 


# RAJEHAX 
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import traceback 
url = "http://www. sogou. com" 
# 访问 sogou Pf Ji 
self.driver.get(url) 
# 通过 driver 对 条 implicitly wait() Jr A EE ERARE PRI I, Jt IC ARR 10 Eh 
self. driver. implicitly wait(10) 
try: 
* ER sogou Ff EI 18 fi A fi CIBUS 
searchBox - self.driver.find element by id("query") 
# (EIU A Eg A " 光 歼 之 路 月 动 化 测试 ” 
searchBox. send keys(u" 光 荣 之 路 自动 化 测试 ") 
# HE sogou Pf EIE TE t I ICZ 
click = self.driver.find element by id("stb") 
# quiescit 
click.click() 
except (NoSuchElementException, TimeoutException), e: 
# TELS R HHE HE ER 
traceback.print exc() 

更 多 说 明 : 

隐 式 等 待 的 好 处 是 不 用 像 强 制 等 待 (time. sleep(n) ) 方 法 一 样 死 等 固定 时 间 n 秒 , 可 以 
在 一 定 程度 上 提升 测试 用 例 的 执行 效率 。 不 过 这 种 方法 也 存在 一 个 弊端 , 那 就 是 程序 会 一 
直 等 待 整个 页 面 加载 完 成 ,也 就 是 说 浏览 器 窗口 标签 栏 中 不 再 出 现 转动 的 小 圆圈 , 才 会 继续 
执行 下 一 步 ,比如 某 些 时 候 想 要 的 页 面 元 素 早 就 加 载 完成 了 ,但 由 于 个 别 JS 等 资源 加 载 稍 
慢 , 此 时 程序 仍然 会 等 待 页 面 全 部 加 载 完 成 才 会 继续 执行 下 一 步 ,这 无 形 中 加 长 了 测试 用 例 
的 执行 时 间 。 


隐 式 等 待 时 间 只 需要 被 设置 一 次 ,然后 它 将 在 driver 的 整个 生命 周期 都 起 


注意 日 ua 


10.37 i EI. 


上 面 我 们 介绍 了 强制 等 待 和 隐 式 等 待 ,这 里 再 介绍 一 种 更 智能 的 等 待 方式 一 一 显 式 等 
待 。 通 过 selenium. webdriver. support. ui 模块 提供 的 WebDriverWait 类 ,再 结合 该 类 的 
until() 和 until_not() 方 法 ,并 自 定 义 好 显 式 等 待 的 条 件 , 然 后 根据 判断 条 件 而 进行 灵活 的 
等 待 。 显 式 等 待 比 隐 式 等 待 更 节约 测试 脚本 执行 时 间 ,推荐 尽量 使 用 显 式 等 待 方 式 来 判断 
页 面 元 素 是 否 存在 。 

显 式 等 待 工作 原理 : 

程序 会 每 隔 一 段 时 间 ( 该 时 间 一 般 都 很 短 ,默认 为 0.5 秒 ,也 可 以 自 定 义 ) 执 行 一 下 自 定 
义 的 判定 条 件 , 如 果 条 件 成 立 ,就 执行 下 一 步 , 否 则 继续 等 待 , 直 到 超过 设 定 的 最 长 等 待 时 
TH] ,然后 抛 出 TimeoutException 异常 。 

WebDriverWait 类 解析 : 

WebDriverWait 类 的 构造 方法 如 下 : 
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. init (self, driver, timeout, poll frequency - 0.5, ignored exceptions - None) 


参数 解释 : 

driver: WebDriver 实例 对 象 (le, Firefox. Chrome or Remote). 

timeout; 最 长 的 显 式 等 待 时 间 , 单 位 为 秒 。 

poll frequency: 调用 频率 ,也 就 是 在 timeout 时 间 段 内 ,每 隔 poll frequency 时 间 执 行 
一 次 判断 条 件 ,默认 为 0. 5 秒 。 

ignored exceptions; 执行 过 程 中 忽略 的 异常 类 型 ,默认 只 忽略 NoSuchElementException 异 
常 类 。 

WebDriverWait 类 提供 的 方法 : 

(1) until(method, message— '') 

在 规定 等 待 时 间 内 ,每 隔 一 段 时 间 调 用 一 下 method 方法 ,直到 其 返回 值 不 为 False. 如 
果 超 时 抛 出 带 有 message 异常 信息 的 TimeoutException 异常 。 

(2) until_not(method, message='') 

与 until() 方 法 相反 ,表示 在 规定 时 间 内 ,每 隔 一 段 时 间 调 用 一 下 method 方法 ,直到 其 
返回 值 为 False, 如果 超时 抛 出 带 有 message 异常 信息 的 TimeoutException 异常 。 

被 测试 网 页 的 HTML 代码 : 


<html> 
<head> 
<meta http- equiv = 'Content - Type' content = 'text/html; charset = utf -8'> 
<title> 你 喜欢 的 水 果 </title> 
«script type = "text/javascript"» 
function display alert() 
{ 
alert("I am an alert box! !") 
} 
</script> 
</head> 
< body> 
<p> 请 选择 你 爱 吃 的 水 果 </p> 
<br> 
< select name = 'fruit'^ 
<option id= 'peach' value= 'taozi'> 桃 子 </option> 
<option id= 'watermelon' value = 'xigua'> 西 瓜 </option> 
</select> 
<br> 
< input type = "button" onclick = "display alert()" value= "Display alert box" /> 
< input id = "check" type = 'checkbox'> 是 否 喜欢 吃水 果 ?</input> 
<br><br> 
< input type = "text" id = "text" value = "今年 夏天 西瓜 相当 甜 ! "> 文本 框 </input > 
</body> 
</html > 


调用 API 的 实例 代码 : 


def test explicitWait(self): 
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# FARK 
import traceback 
# FA By% 
from selenium. webdriver. common. by import By 
# GARDE 
from selenium. webdriver. support. ui import WebDriverWait 
# FAMED SUE 
from selenium. webdriver. support import expected_conditions as EC 
from selenium. common. exceptions import TimeoutException, NoSuchElementException 
url = "d:Wtest. html" 
# 访问 自 动 以 测试 网 页 
self.driver.get(url) 
try: 
wait = WebDriverWait(self.driver, 10, 0.2) 
wait. until(EC.title_is(u" 你 喜欢 的 水 果 ")) 
print u" 网 页 标题 是 "你 喜欢 的 水 果 "" 
# GIF 10 fb, KEZE TES Fc HT HL 3E 
element = WebDriverWait(self.driver, 10). untilV 
(lambda x: x.find element by xpathV 
("//input[(4 value = 'Display alert box']")) 
element. click( ) 
# alert ffe fi H 
alert - wait.until(EC.alert is present()) 
# FTE alert HEIKE 
print alert. text 
# aih Be a E 
alert.accept() 
# 获取 id 属性 简 为 "peach "的 页 面 无 素 
peach = self.driver.find element by id("peach") 
# 判断 id lH tE fiA "peach" fli WE IE 76 3X AE s hE B i P 
peachElement - wait.until(EC. element to be selected(peach)) 
print 下 拉 列 表 的 选项 "桃子 " 目前 处 于 选中 状态 ” 
# NINE AI UE fe 48 s PT LAE HL RE BE T ili 
wait.until(EC.element to be clickable((By.ID, 'check'))) 
print v' 复 选 框 可 见 并 且 能 被 单 击 ” 
except TimeoutException, e: 
# Miik TimeoutException S% 
print traceback. print_exc() 
except NoSuchElementException, e: 
# HAK NoSuchElementException 异常 
print traceback. print_exc() 
except Exception, e: 
# MEHEK 
print traceback. print_exc() 


期 望 的 场景 





在 自动 化 实施 过 程 中 ,常常 会 有 在 执行 某 步 操作 或 者 某 个 命令 之 前 , 先 看 看 要 操作 的 元 
素 是 否 处 于 显示 状态 .是否 可 操作 等 需求 ,也 就 是 看 看 我 们 期 望 的 场景 是 否 存在 。 
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WebDriver 中 支持 的 场景 方法 均 来 自 selenium. webdriver. support. expected _ 
conditions 模块 ,所 有 的 场景 方法 如 下 。 被 测试 网 页 HTML 代码 同 10.37 节 。 

> alert is presentO : 判断 页 面 是 否 出 现 alert 框 。 显 式 等 待 中 使 用 方法 : 
wait = WebDriverWait(driver, 10) 
# 打印 一 下 alert 框 消息 
wait.until(EC.alert is present()).text 

> element located selection state to be(locator. state): 判断 一 个 元 素 的 状态 是 否 
是 给 定 的 选择 状态 ,第 一 个 传人 的 参数 是 一 个 定位 器 ,定位 器 是 一 个 元 组 (by， 
path) ,第 二 个 参数 表示 期 望 的 元 素 状态 , True 表 选 中 状态 ,False 表 未 选中 状态 。 相 
等 返回 True, 和 否则 返回 False。 显 式 等 待 中 使 用 方法 : 
# True 
wait.until(EC.element located selection state to be((By.ID, "peach"), True)) 
# False 
wait.until not(EC.element located selection state to be((By.ID, "watermelon"), True)) 
# 原 型 
EC.element located selection state to be((By.ID, "peach"), True) .is selected 

> element selection state to be(driverObject. state); 判断 给 定 的 元 素 是 否 被 选中 ， 
第 一 个 参数 是 一 个 WebDriver 对 象 ,第 二 个 是 期 望 的 元 素 的 状态 ,相等 返回 True. 
否则 返回 False。 显 式 等 待 中 使 用 方法 : 
* True 
wait.until(EC.element selection state to be(driver.find element by id("peach"), True)) 
* False 
wait.until not(EC. element selection state to be(driver. find element by id("peach"), 


False)) 
# 原型 


EC.element selection state to be (driver. find element by_id("peach"), True) . is_ 
selected, 


> element located to be selected(locator) ; 期 望 某 个 元 素 处 于 选中 状态 ,参数 为 一 个 
定位 器 。 显 式 等 待 中 使 用 方法 : 


wait. until (EC. element located to be selected((By. ID, "peach"))) 


> element to be selected(driverObject) ; 期 望 某 个 元 素 处 于 选中 状态 ,参数 为 一 个 
WebDriver 实例 对 象 。 显 式 等 待 中 使 用 方法 : 


wait.until(EC.element to be selected(driver.find element by id("peach"))) 


> element to be clickableClocator); 判断 某 元 素 是 否 可 见 并 且 能 被 单 击 ,条 件 满足 返 
回 该 页 面 元 素 对 象 .否则 返回 False。 显 式 等 待 中 使 用 方法 : 
# 存在 并 可 见 
wait. until(EC. element to be clickable((By. XPATH, '//input[@value = "Display alert box"]'))) 


# 不 存在 
wait.until not(EC.element to be clickable( (By. XPATH, '//input/a"]'))) 
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> frame_to_be_available_and_switch_to_it(parm) : 判断 frame 是 否 可 用 ,如 果 可 用 返 
回 True 并 切入 到 该 frame, 参 数 parm 可 以 是 定位 器 locator 也 就 是 (by，xpath) 组 
成 的 元 组 ,或 者 定位 方式 : id. name, index (该 frame 在 页 面 上 索引 号 ), 或 者 
WebElement 对 象 。 显 式 等 待 中 使 用 方法 : 
测试 网 址 : http://www. 126. com 首页 。 


wait = WebDriverWait(driver, 10, 0.2) 

& f£ A ID ffi"x — URS - iframe" 

wait.until(EC.frame to be available and switch to it((By.ID, "x- URS - iframe"))) 

£ f£ X frame 的 WebElenent 对 象 

wait.until(EC.frame to be available and switch to it(driver.find element by id("x- URS 
— iframe"))) 

* ft A frane 在 页 面 中 的 索引 号 


wait.until(EC.frame to be available and switch to it(1)) 


v 


invisibility of element located(locator): 希望 某 个 元 素 不 可 见 或 者 不 存在 于 DOM 
中 ,满足 条 件 返 回 True, 和 否则 返回 定位 到 的 元 素 对 象 。 显 式 等 待 中 使 用 方法 : 
wait.until(EC.invisibility of element located((By. ID, "watermelon2"))) 


visibility of element located(locator) ; 希望 某 个 元 素 出 现在 页 面 的 DOM 中 ,并 且 
可 见 , 如 果 满 足 条件 返 回 该 元 素 的 页 面 元 素 对 象 。 显 式 等 待 中 使 用 方法 : 


v 


element = wait.until(EC.visibility of element located((By. ID, "peach"))) 


visibility of WebElement ; 希望 某 个 元 素 出 现在 页 面 的 DOM 中 ,并 且 可 见 , 如 果 
满足 条 件 返回 该 元 素 的 页 面 元 素 对象 。 显 式 等 待 中 使 用 方法 : 


element =wait.until(EC. visibility of(driver. find_element_by_id("peach"))) 


v 


v 


visibility of any elements located(locator): 判断 页 面 上 至 少 一 个 元 素 可 见 , 返 回 
满足 条 件 的 所 有 页 面 元 素 对 象 。 显 式 等 待 中 使 用 方法 : 


inputs = wait.until(EC.visibility of any elements located((By. TAG NAME, "input"))) 


> presence of all elements located(locator); 判断 页 面 上 至 少 有 一 个 元 素 出 现 , 如 果 
满足 条 件 返 回 所 有 满足 定位 表达 式 的 页 面 元 素 。 显 式 等 待 中 使 用 方法 : 


elements = wait.until(EC.presence of all elements located((By. ID, "text"))) 


presence of element located(locator); 判断 某 个 元 素 是 否 出 现在 DOM 中 ,不 一 定 
可 见 ,存在 返回 该 页 面 元 素 对 象 。 显 式 等 待 中 使 用 方法 : 

# 存在 

wait. until(EC.presence_of element located((By.ID, "check"))) 

# 不 存在 

wait.until not(EC.presence of element located((By.ID, "div2"))) 

> staleness of WebElemeno ; 判断 一 个 元 素 是 否 仍 在 DOM 中 ,如 果 在 规定 时 间 内 已 
经 移 除 返回 True, 和 否则 返回 False。 显 式 等 待 中 使 用 方法 : 


v 
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wait.until(EC.staleness of(driver.find element by id("check"))) 


» text to be present in element(locator. text) ; 判断 文本 内 容 text 是 否 出 现在 某 个 
元 素 中 ,判断 的 是 元 素 的 text。 显 式 等 待 中 使 用 方法 : 


wait.until(EC.text to be present in element((By.TAG NAME, "P"), "请 选择 你 爱 吃 的 水 果 ")) 


> text_to_be_present_in_element_value(locator, text) ; 判断 text 是 否 出 现在 元 素 的 


value 属性 值 中 。 显 式 等 待 中 使 用 方法 : 


wait.until(EC.text to be present in element value((By.ID, "peach"), "taozi")) 


> title contains (pardal title) ; 判断 页 面 title 标签 内 容 是 否 包 含 partial_title, 只 需要 
部 分 匹配 即 可 ,包含 返回 True, 和 否则 返回 False。 显 式 等 待 中 使 用 方法 : 


wait. until(EC.title contains(" 欢 的 水 果 ") ) 
> title isCtitle tex) ; 判断 页 面 title 内 容 是 与 传人 的 title_text 内 容 完 全 匹配 ,匹配 返 
El True, 否则 返回 False。 显 式 等 待 中 使 用 方法 : 


# 完全 匹配 

wait. until(EC.title_is(" 你 喜欢 的 水 果 ")) 

上 不 完全 匹配 

wait. until_not(EC.title_is(" 你 喜欢 的 水 果 3")) 


10.39 KEEN 属性 识别 和 操作 新 弹出 的 浏览 器 窗口 





用 于 测试 的 网 页 的 HTML 代码 : 


<html > 
<head > 
<title> 你 喜欢 的 水 果 </title> 
<meta http- equiv = "Content - Type" content = "text/html; charset = utf — 8" /> 
</head> 
< body > 
<p id= 'p1'> 你 爱 吃 的 水 果 么 ?</p> 
<br><br> 
<a href = "http://www. sogou. con" target = ”blank"> sogou 搜索 </a> 
</body > 
«/htnl» 


调用 API 的 实例 代码 : 


def test identifyPopUpWindowByTitle(self): 
# 导 人 多 个 异常 类 型 
from selenium. common. exceptions import NoSuchhindowException, V 
TimeoutException 
BORA SUE 
from selenium. webdriver. support import expected conditions as EC 
# FA By% 


from selenium. webdriver. common. by import By 
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# FA WebDriverWait 类 
from selenium. webdriver. support. ui import WebDriverWait 
# FARK 
import traceback 
# 时 人 肝 间 模块 
import time 
url = "d:Wtest. html" 
# 访问 月 动 已 测试 网 页 
self.driver.get(url) 
* BREGETH IE E BEBE XP Oy "sogou ER" WEEK, TESI Aili E 
WebDriverWait(self.driver, 10, 0.2). until(EC. element to be clickableV 
((By.LINK TEXT, 'sogou 122 $2 ')) ). click() 
# IEI hi A ATIF HUE VE EET EI] fo 
all handles - self.driver.window handles 
# TED SE nid VE ie TEIL AT 
print self.driver.current window handle 
# TEHTJFIU ME e BIET IO C 
print len(all handles) 
# WR2E,UUEWAFIITAUR 
tine. sleep(2) 
UL FE EU V i BIET IET E A E, PERLE] all handles "f Br fr HU Wi die e] 
if len(all handles) » 0: 
try: 
for windowHandle in all handles: 
# mkan 
self.driver.switch to.window(windowHandle) 
print self.driver.title 
# Ii ni poU E e HEEL I title TES ART 
E "esslSt - 上 网 从 规 独 开始 " 
if self.driver.title == 凤 "搜狗 搜索 引擎 - 上 网 从 搜狗 开始 ”: 
EORUM TT IE R ih A TE EUR, 
# 然后 答 人 "sogou Pf IHY NI W de BI CT REIREI" 
WebDriverWait(self.driver, 10, 0.2). untilV 
(lambda x: x.find element by id("query")).V 
send keys(u" sogou 首页 的 浏览 器 窗口 被 找到 ”) 
time. sleep(2) 
except NoSuchWindowException, e: 
# 捕获 NoSuchWindowException Ha 
print traceback. print exc() 
except TimeoutException, e: 
# MiK TimeoutException F% 
print traceback. print exc() 
A JENIE B ET UI ELECTA TH 
self.driver.switch to.window(all handles[0]) 
print self.driver.title 
# Mrz iN E d BELT title BTE JE" I EO IO" 
self.assertEqual(self.driver.title, w" 你 喜欢 的 水 果 ") 
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10.40 过 页 面 的 关键 内 容 识 别 和 操 





用 于 测试 网 页 的 HTML 代码 : 
同 10. 39 节 的 被 测试 网 页 的 HTML 代码 。 
调用 API 的 实例 代码 : 


def test identifyPopUpWindowByPageSource( self): 
# 时 人 多 个 异 芒 类 型 
from selenium. common. exceptions import NoSuchWindowException,V 
TimeoutException 
EOWAJUI E SE 
from selenium. webdriver. support import expected conditions as EC 
# FA By% 
from selenium. webdriver. common. by import By 
# 5 A WebDriverWait 类 
from selenium. webdriver.support.ui import WebDriverWait 
# GAME 
import traceback 
ESAMI EEG 
import time 
url = "d:Wtest. html" 
# 访问 自动 已 测试 网 页 
self.driver.get(url) 
# 插 式 等 符 找 到 页 面 上 链接 文字 为 "sogou IER "MERIC, 找到 后 单 击 它 
WebDriverWait(self.driver, 10, 0.2). until(EC. element to be clickableV 
( (By. LINK TEXT, 'sogou 12 2: '))).click() 
# DEI G DE PER TT TER U MEET EI] AT 
all handles - self.driver.window handles 
# TED nir d VE ETE] AT 
print self.driver.current window handle 
# ITEIHITJERU OU VE AE BI ID 3t 
print len(all handles) 
# GIF 2 秘 ,以便 更 好 地 查看 效 扶 
time. sleep(2) 
# MRTE hd V. e BI O TT EAS 2v 55, PEEL I] all handles rf Br fr f oU Vi e 6] 4A. 
if len(all handles) » 0: 
try: 
for windowHandle in all handles: 
# grao 
self.driver.switch to.window(windowHandle) 
# IEI Hi id V e BE ELI CIE IR F3 
pageSource - self.driver.page source 
if u" 搜 狗 搜索 ”in pageSource: 
# MAGIE IER ia A HEMER, 
然后 答 人 "sogou Ef DT ÁY Ù e BILL ERES" 
WebDriverWait(self.driver, 10, 0.2). untilV 
(lambda x: x.find element by id("query")).V 
send keys(u" sogou 首页 的 浏览 器 窗口 被 找到 " ) 
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tine. sleep(2) 
except NoSuchWindowException, e: 
# UMRE PNI I aeg HN, ZI HI NoSuchltindowException $A, 
# 打印 异常 的 堆栈 信息 
print traceback. print exc() 
except TimeoutException, e: 
# BGF HEHH ii TineoutException $ f 
# FTESE A h ERE 
print traceback. print_exc() 
# EDU E E BT CI EI S pL RA BT ET 
self.driver.switch to. window(all handles[0]) 
# ME zr di VR i BIET CIBC RE n AEG x" TREIE IIR AT "ERE 
self.assertTrue(u" AR E Rz BJ 27K R 4,?" in self.driver.page source) 


10.41 FE Frame 中 的 页 3 


有 时 网 页 中 会 嵌 套 一 个 或 多 个 Frame, 此 时 如 果 我 们 直接 去 找 嵌 套 在 Frame 里 的 页 面 
元 素 就 会 抛 出 NoSuchElementException 异常 ,所 以 在 操作 组 套 存 Frame 里 面 的 页 面 元 素 
之 前 ,需要 将 页 面 焦点 切换 到 Frame 里 。 

目的 : 

将 当 
面 元 素 。 

用 于 测试 网 页 的 HTML 代码 : 


frameset. html 页 面 代码 ; 





切换 到 Frame 中 ,并 在 不 同 的 Frame 间 互 相 切 换 ,同时 操作 Frame 中 的 页 





<html> 
<head> 

«title» frameset 页 面 </title> 

«neta http - equiv = "Content - Type" content = "text/html; charset = utf - 8" /> 
</head> 
< frameset cols = "25 % ,50% ,25% "> 

< frame id = "leftframe" src = "frame_left. html" /> 

<frame id = "niddleframe" src = "frame_middle. html" /> 

< frame id = "rightframe" src= "frame right.html" /> 
</ frameset > 
</html > 


frame left. html 页 面 代码 : 


<html> 
<head> 
<title> 左 侧 frame </title> 
«neta http - equiv = "Content - Type" content = "text/html; charset = utf - 8" /> 
< script type = "text/javascript"» 
function display alert() 
{ 
alert("I am an alert box! !") 
) 
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</script> 
</head> 
<body> 
<p> 这 是 左 侧 frame 页 面 上 的 文字 </p> 
< input type = "button" onclick = "display alert()" value= "Display alert box" /> 
</body> 
</html > 


frame middle. html 页 面 代码 : 


<html> 
<head> 
<title> 中 间 frame </title> 
«meta http - equiv = "Content - Type" content = "text/html; charset = utf — 8" /> 
</head> 
<body > 
<p> 这 是 中 间 frame 页 面 上 的 文字 </p> 
< input type = "text" id = "text" value = ""> 文 本 框 </input > 
</body> 
</html > 


frame right. html 页 面 代码 : 


<html> 
<head> 
«title^fifll frame </title> 
<meta http - equiv = "Content - Type" content = "text/html; charset = utf - 8" /> 
</head> 
<body > 
<p> 这 是 右 侧 frame 页 面 上 的 文字 </p> 
< input id = "python" type = 'radio' name = "book" checked > python selenium </input > 
<br /> 
< input id = "java" type= 'radio' name = "book"> java selenium </input > 
</body> 
</html> 


将 这 4 个 HTML 文件 放 到 同一 目录 下 。 





将 frameset. html 文件 直接 拖 搜 到 浏览 器 窗口 ,展示 的 页 面 效果 如 图 10-2 所 示 。 
Ee GENLNLOTILL 273» 3 C OEENmO8 


[€ i Medio femen c [a 2a 如 e ©. eir 3l 
REEM frame 页 面 上 的 文字 这 是 中 间 frame 页 面 上 的 文字 JUR frame 页 面 上 的 文字 
1 Display ost bax 文本 框 © python selenium. 
^^ java selenium 
图 10-2 


调用 API 的 实例 代码 : 


def test HandleFrame(self): 
from selenium. webdriver. support import expected conditions as EC 
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from selenium. webdriver.support.ui import WebDriverWait 
from selenium.common.exceptions import TimeoutException 
url = "d: Wframeset. html" 
# Wi FE GM BC 
self.driver.get(url) 
# EHI Zr A EIER frane KH, RIGA 0 JF f. 
# WARA PHK frane, gi E (B HI 9| G 1 
# 如 果 没 有 使 用 此 行 代码 , 则 无 法 扒 到 页 面 中 左 侧 frame 中 的 在 何 页 面 元 素 
self. driver. switch to. frame(0) 
# RIEM frame 中 的 p HENK 
leftFrameText = self.driver.find element by xpath("//p") 
3MERETE MM frame 中 的 文字 是 否 和 "这 是 左 侧 frane HH EA CE JL ERES LÀ RC 
self.assertAlmostEqual(leftFrameText.text, u" 这 是 左 侧 frame 页 面 上 的 文字 ") 
# RIJEN frame "I Ez IK, JE P de AU 
self.driver.find element by tag name("input").click() 
try: 
# sp alert B fkih H 
alertWindow - WebDriverWait(self.driver, 10).until(EC.alert is present()) 
# 打印 alert 消息 
print alertWindow. text 
alertWindow.accept() 
except TimeoutException, e: 
print e 
# fJ driver. switchTo. default content 方法 ,从 左 仙 frame 中 返回 到 frameset 页 面 
# 如 黑 不 调用 此 行 代码 , I JE IE M Ze fI frame Tt ili f M EA HEN frame 页 面 
self.driver.switch to.default content() 


# 通过 标签 名 找到 页 面 中 所 有 的 frame R, IR ril d c | Ut A IE frame 

self. driver. switch_to. frame(self.driver.find elements by tag name("frame")[1]) 
* MR REPE E E IEUIX li] frame Ft ili Eg x 3 "eB FR 

assert u" 这 是 中 间 frame 页 面 上 的 文字 ”in self.driver.page source 

# ERA PRA" REP frame” 

self.driver.find element by tag nane("input").send keys(u" 我 在 中 间 frame") 
self.driver.switch to. default content() 


self.driver.switch to. frame(self.driver.find element by id("rightframe")) 
assert u" 这 是 右 侧 frame 页 面 上 的 文字 ”in self.driver.page source 
self. driver. switch to. default_content() 

更 多 说 明 : 

切 进 frame 和 切 出 frame 的 方法 ,在 较 低 版 本 的 selenium 中 ,提供 的 是 driver. switch_to_ 
frame() 和 driver. switch_to_default_content() 方 法 ,而 本 书 使 用 的 selenium 版 本 已 经 推荐 
用 户 使 用 driver. switch_to. frame() 和 driver. switch. to. default_content() 方 法 进行 代替 ， 
但 同时 也 是 兼容 老 版 本 的 。 














10.42 BEES E UI 





码 内 容 操 作 Frame 


目的 : 
能 够 使 用 Frame 页 面 的 HTML 源码 定位 指定 的 Frame 页 面 并 进行 操作 。 
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用 于 测试 的 HTML 代码 : 
IH] 10. 41 节 被 测试 页 面 的 HTML 代码 。 
调用 API 实例 代码 : 


def test HandleFrameByPageSource( self): 
url = "d: Wframeset. html" 
# Op FE XM BC 
self.driver.get(url) 
# RITH E BEER frame VOI XE H MPH Y franesList 列表 中 
framesList = self.driver.find elements by tag nanme("frame") 
# 通过 for MIRR HI franesList 中 所 有 的 frame W ili], e 4€ VU IB BP PAA 
£ "中 间 frame" 的 frame 页 面 
for frame in framesList: 
# HAFI frame 页 面 
self. driver. switch to.frame(frame) 
# 判断 每 个 frane 的 HTML 源码 由 是 否 包 含 "中间 frame" JL X ftis] 
if u" 中 间 frame" in self.driver.page source: 
E 如 打包 合 需 要 查找 的 关键 字 , 则 查找 到 页 面 上 的 p Este ox 
p = self.driver.find element by xpath("//p") 
# 断言 页 面 上 忆 元 素 文 杰 内 容 是 再 是 "这 是 中间 frame 页 面 上 的 文字 ” 
self. assertAlmostEqual(u" 这 是 中 间 frame 页 面 上 的 文字 "，p.text) 
# 退出 frame 
self.driver.switch to.default content() 
# 找到 指定 的 Frame Till, JE MU I BOTE TE IE IB HL RTI 
break 
else: 
# 者 奥 没 找到 指定 的 frane, 刚 调 用 此 行 代码 ,返回 到 frameset 页 面 中 
# DB FK for 循环 由 能 继续 调用 driver. switch to. frame 方法 , 否则 会 报错 


self. driver. switch_to. default_content() 


10.43 村 EDEN :ba 


用 于 测试 的 HTML 代码 : 
同 10. 41 节 被 测试 网 页 的 HTML 代码 ,其 中 需要 更 新 一 下 如 下 页 面 的 HTML 代码 。 
修改 frame left. html 页 面 代 码 如 下 : 


<html> 
<head> 
<title> 左 侧 frame </title> 
X neta http - equiv = "Content - Type" content = "text/html; charset = utf — 8" /> 
< script type = "text/javascript"» 
function display alert() 
{ 


alert("I am an alert box! !") 


} 
</script> 
</head> 
<body> 


<p> 这 是 左 侧 frame 页 面 上 的 文字 </p> 
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< input type = "button" onclick= "display alert()" value= "Display alert box" /> 

< iframe id = "showlfame" src = ' iframe. html' style = "width:200px"; height :50px »«/iframe» 
</body> 
</html> 


在 frame left. html 同 级 目录 下 新 增 iframe. html 文件 : 


<html> 
<head> 
<title> iframe </title> 
<meta http- equiv = "Content - Type" content = "text/html; charset = utf — 8" /> 
</head> 
<body > 
<p> 这 是 iframe 页 面 上 的 文字 </p> 
</body> 
</html > 


页 面 展示 效果 如 图 10-3 Bron o 


J 
[€ men EET EELEE 





RRES frame (Gl LS JR Ed frame Tii LIS REEM fame (ii Linc 


tram HS 


en 
图 10-3 


调用 API 的 实例 代码 : 


def test HandleIFrame(self): 
url = "d: Wframeset. html" 
* 访问 自 定义 测试 网 页 
self.driver.get(url) 
# MEREK, UA JU illl E58 — f frane, 也 就 是 左边 的 frame 
self.driver.switch to. frame(0) 
# MEE IA 8 IE TEX 4 7c frame 页 面 上 的 文字 "关键 字 毕 ， 
# OFB AER HE frame 页 面 
assert u" 这 是 左 侧 frame 页 面 上 的 文字 ”in self.driver.page source 


# MEIRE, HA id 为 "showIfame" 的 iframe 页 面 
self. driver. switch to. frame(self.driver.find element by id("showlIfame")) 


# ie d BETE "E iframe W EL] XE IBS RES, 
# DUBII IE BRY UI E iframe 页 面 
assert u" 这 是 iframe 页 面 上 的 文字 ”in self.driver.page source 


# 将 操作 区 域 切 找到 frameset Jt ilii, LA ERE IR DI EA Hf frame 
self.driver.switch to.default content() 
# Bre X title fiile 4; Jy" franeset 页 面 " 


assert u'frameset 页 面 " == self.driver.title 


# 改变 操作 区 城 ,切换 进 人 中 间 frame 页 面 


。164 。 


第 10 章 WebDriver API 详解 


self. driver. switch to. frame(1) 
# Boc UA EJ d fr fe "EP frame 页 面 上 的 文字 "这 样 的 关键 字 叫 
assert u" 这 是 中 间 frame 页 面 上 的 文字 ”in self.driver.page source 


更 多 说 明 : 

CD 如 果 在 一 个 frame 中 又 内 做 了 iframe, 此 时 如 果 想 进入 这 个 内 艇 的 iframe, 必 须 先 
进入 frame, 然 后 才能 进入 iframe 页 面 。 

(2) 在 一 个 frame F X: ie IK EA Z Ib EN Bx frame 或 iframe, 调 用 一 次 driver. 
switch to. default content ) 函 数 都 会 直接 从 所 有 的 frame 中 切换 出 来 回 到 默认 页 面 , 比 如 


本 例 的 frameset 页 面 。 


10.44 REEN d: oV ad 3] 


目标 : 
能 够 模拟 鼠标 单 击 弹出 的 Alert 窗口 上 的 “确定 ”按钮 。 
用 于 测试 网 页 的 HTML 代码 : 


<html > 
X head» 
<title> 你 喜欢 的 水 果 </title> 
<meta http- equiv = "Content - Type" content = "text/html; charset = utf - 8" /> 
</head> 
< body > 
< input id = 'button' type = 'button' onclick = "alert(' 这 是 一 个 alert 弹出 框 ');" 
value = ' 单 击 此 按钮 ,弹出 alert 弹 窗 '/> 
«/ input» 
</body> 
</html > 


该 HTML 代码 在 浏览 器 中 展示 弹 窗 的 效果 图 如 图 10-4 所 示 。 










来 自 网 页 的 消息 





A 这 是 一 个 alert 弹出 框 














调用 API 的 实例 代码 : 


def test HandleAlert(self): 
from selenium. common. exceptions import NoAlertPresentException 


import time 
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url = "d:\\alert. html" 

# We AEX WA 

self. driver. get (url) 

# 通过 id f PE fiie ie D E Ate 

button = self. driver. find element by id("button") 

# Aht HDU, WEIT Alert if BE, 

# 上 面 显示 "这 是 一 个 alert SRI fe" Rl" lig "ef 

button. click() 

try: 
# ff] driver. switch to alert() Jr ic Kt alert 对 条 
alert - self.driver.switch to alert() 
tine. sleep(2) 
# {EJH alert. text [B E 3€Jk alert EPAR, 
# 间断 言 文字 内 众 是 否 是 "这 是 一 个 alert Hih HE" 
self.assertEqual(alert.text, u" 这 是 一 个 alert 弹出 框 ") 
* WH alert 对 条 的 accept() 方 法 ,模拟 展 奈 单 击 alert 7e E hg" WE "tH 
# UER alert ffc 
alert.accept() 

except NoAlertPresentException, e: 
# 如 朵 Alert EKM HI d Te VE Il] E, WAN H1. NoAlertPresentException 的 蜡 党 
self. fail(" 尝 试 操作 的 alert 框 未 被 找到 ") 


print e 


更 多 说 明 
在 本 书 使 用 的 selenium 版 本 中 ,已 经 推荐 用 户 使 用 driver. switch. to. alert 来 代替 
driver. switch to. alert() 方 法 获取 Alert 对 象 。 


10.45 REEN: EALE A 


目标 : 
能 够 模拟 鼠标 单 击 JavaScript 弹出 的 confirm 框 中 的 “确定 ”和 “取消 ”按钮 。 
用 于 测试 网 页 的 HTML 代码 : 


<html> 
<head> 
<title> 你 喜欢 的 水 果 </title> 
«neta http- equiv = "Content - Type" content = "text/html; charset = utf - 8" /> 
</head> 
< body > 
< input id = 'button' type = 'button' onclick = "confirm(' 这 是 一 个 confirm 弹出 框 ');" 
value= ' 单 击 此 按钮 ,弹出 confirm 弹出 窗 '/> 
</input > 
</body> 
</html > 


该 HTML 代码 在 浏览 器 中 展示 弹 窗 效果 图 如 图 10-5 Bron o 
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来 自 网 页 的 消息 








e 这 是 一 个 confirm 弹出 框 











调用 API 的 实例 代码 : 


def test Handleconfirm(self): 

from selenium. common. exceptions import NoAlertPresentException 

import time 

url = "d:\\confirm. html" 

* 访问 自动 已 测试 网 页 

self.driver.get(url) 

# 通过 id mfE[fi rd vui EU feto 

button - self.driver.find element by id("button") 

# onlifefll oo , 则 会 弹出 一 个 confirm BU fie, 

* 上 而 显示 "这 是 一 个 confirm Pih HE" DL "ll e "o "Pe fl 

button. click() 

try: 
# BREHY selenium 推荐 合用 driver. switch to.alert Jy fet 
# driver. switch to. alert 方法 夹 获取 alert 对 条 
alert - self.driver.switch to.alert 
tine. sleep(2) 
# (EM alert. text [BTE ER confirm HE H ALTE, 
# 间断 言 文 字 内 和 众 是 否 是 "这 是 一 个 confirm 9R HH HE" 
self.assertEqual(alert.text, u" 这 是 一 个 confirm 弹出 框 ") 
# WJH alert 对 条 的 accept () Jri, BUD lUi n il; confirm REI E hh "lt "HEEL 
# 以 便 关闭 confirm fft 
alert.accept() 
# JH FITE EE, Sb ES EEUU id; confirm HEE hg "Hi "efl 
# alert. disniss() 

except NoAlertPresentException, e: 
# MÆ confirm EKP fd zs TE Vi ili E, MANH NoAlertPresentException 的 异常 
self. fail(" 尝 试 操作 的 confirm 框 未 被 找到 ") 


print e 


10.46 EM 


Him: 
能 够 在 JavaScript 的 prompt 弹 窗 中 输入 自 定义 的 内 容 ,并 单 击 “ 确 定 ” 按 钮 或 “取消 ” 
按钮 。 
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用 于 测试 网 页 的 HTML 代码 : 


<html> 
<head> 
<title> 你 喜欢 的 水 果 </title> 
«neta http- equiv = "Content - Type" content = "text/html; charset = utf — 8" /> 
</head> 
<body > 
< input id = 'button' type = 'button' onclick = "prompt(' 这 是 一 个 prompt 弹出 框 ');" 
value= ' 单 击 此 按钮 ,弹出 prompt 弹出 框 '/> 
</input > 
«/ body > 
«/htnl > 


该 HTML 代码 在 浏览 器 中 展示 弹 窗 效果 如 图 10-6 所 示 。 





调用 API 的 实例 代码 : 


def testHandlePronpt(self): 
url = "D:W prompt. html" 
# gn Ex XN 
self.driver.get(url) 
* 使 用 这 定 龙 方式 , TESI BE BUDE EE e oc 
element = self.driver.find element by id("button") 
element.click() 
import time 
time. sleep(1) 
Egli TEC, 弹出 一 个 prompt Efi, 
# 上 面 将 显示 "这 是 一 个 prompt PRI E" di AHE. 
zo" "PeEHLBU HE "Be fl 
# 信用 driver. switch to. alert 方法 获取 Alert Xf R 
alert - self.driver.switch to.alert 
# f&J] alert. text 方法 获取 prompt HE F ifi ff] X F, 
# 间断 言 文字 内 众 是 否 和 "这 是 一 个 prompt 2E ife" 
self.assertEqual(u" 这 是 一 个 prompt 弹出 框 ", alert. text) 
time. sleep(1) 
# 调用 alert. send_keys() 方 法 ,在 prompt f fk Jia A HE idi A 
B "HARZEM: 要 想 改变 命运 ,必须 每 天 学 习 2 小 有 时 ! 
alert. send_keys(u" 光 荣 之 路 : 要 想 改 变 命运 , 必须 每 天 学 习 2 小 时 !") 
time. sleep(1) 
# 使 用 alert 对 条 的 accept F, 
# Mili prompt HHY " i xe "Bet, ŽA] prompt fie 
alert. accept( ) 
# (EM alert 对 条 的 dismiss 方法 , 单 击 prompt HE E K "eii " tzt, ŽA] prompt fe 
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# 取消 下 面 一 行 代码 的 注 姑 ,就 会 模 杖 单 击 prompt fi EB  WGH "t tH 


# alert. dismiss() 


10.47 BE: 览 器 的 Cookie 





目标 : 

能 够 遍历 输出 Cookie 信息 中 所 有 的 key 和 value; 能 够 删除 指定 的 Cookie 对 象 ; 能 够 
删除 所 有 的 Cookie 对 象 。 

用 于 测试 的 网 址 : 


http://www. sogou. com 


调用 API 的 实例 代码 : 


def test Cookie(self): 
url = "http://www. sogou. com" 
# 访问 sogou Pj Jr 
self.driver.get(url) 
* 得 到 当前 页 面 下 所 有 的 Cookies, Jff ih € [PE fe JH name, value, fr AUI FN HEIE 
cookies = self.driver.get cookies() 
for cookie in cookies: 
print"$s -» $s-»5s-»55$s-»5s"WN 
% (cookie['domain'], cookie["name" ], cookie["value"], V 


cookie["expiry" ], cookie[" path" ]) 


# WREE Cookie 的 nane 从 获取 该 条 Cookie 信息 , 获取 name 位 为 'SUV' 的 Cookie 信息 
ck = self. driver. get_cookie("SUV") 
print" %s ->%s ->%s -> $s -> %8" \ 

% (ck['domain'], ck["name" ], ck["value"], \ 


ck["expiry"], ck["path" ]) 


* MBE cookie 有 两 逢 方法 
Z 第 一 秒 : 通过 Cookie 的 name 属性 ,删除 name (fi žy "ABTEST" fff] Cookie 信息 
print self.driver.delete cookie(" ABTEST") 


# BPP: 一 次 性 删除 全 部 Cookie 信息 
self.driver.delete all cookies() 

# 删除 全 部 Cookie 后 ,再 次 查看 Cookies, 确认 是 否 已 说 全 部 删除 
cookies = self.driver.get cookies() 


print cookies 


# HIE XE X Cookie ff El 

self.driver.add cookie(("name" :"gloryroadTrain", 'value': '1479697159269020' ]) 
# 查看 添加 的 Cookie f E 

cookie = self.driver.get cookie("gloryroadTrain") 


print cookie 
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10.48 村 二 Ea 


常会 遇 到 加 载 某 一 个 页 面 需要 等 待 很 长 时 间 , 其 实 页 面 基 
本 元 素 都 已 经 加 载 完 成 ,可 以 进行 后 续 操 作 , 而 SeleniumWebDriver 在 执行 get 方法 时 会 一 
直 等 待 页 面 完 全 加 载 完毕 以 后 才 会 执行 后 续 操 作 , 这 无 形 中 增加 了 自动 化 测试 的 时 间 , 针 对 
此 种 情况 ,就 需要 指定 一 下 页 面 加 载 超时 时 间 ,到 达 等 待 时 间 点 不 再 继续 等 待 加 载 ,而 是 继 
续 执 行 后 续 操作 。 
用 于 测试 的 网 址 : 


http://mail. 126. com 
实例 代码 : 


#encoding= utf - 8 

from selenium import webdriver 

from selenium. common. exceptions import TimeoutException 
from selenium. webdriver. common. keys import Keys 

import time 

import unittest 


class setPageLoadTime(unittest. TestCase) : 
def setUp(self): 
# 启动 Firefox MX H d 


self.driver = webdriver.Firefox(executable path- "c: geckodriver" ) 


def test PageLoadTinme(self): 
# Bg v M ACER d et Yy 4 Rh 
self.driver.set page load timeout(4) 
self.driver.maximize window() 
try: 
startTime = time. time() 
self. driver. get(" http: //mail.126.com") 
except TineoutException: 
print u' 页 面 加 载 超过 设 定时 间 , 超时 ' 
# G AT DIAC IB] AR ERE RE BF HI, 
# 通过 执行 Javascript Æ PF IE IIIA, IT MEE WATI E RD E 
self.driver.execute script('window.stop()') 
end = time. time() — startTime 
print end 
# 切换 进 frame tft 
self.driver. switch to.frame("x- URS - iframe") 
# KRAP KAHE 
userName = self. driver. find element by xpath( '//input[ @nane = "email" ]') 
# MAMP 
userName. send keys(" xxx" ) 
# KRAHE 
pwd = self. driver. find element by xpath("//input[@name= 'password']") 
# 输 人 第 码 
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pwd. send keys(" xxx" ) 
* 发 送 一 个 Enter fif 
pwd. send keys(Keys. RETURN) 


def tearDown(self): 
self.driver.quit() 


if name == ' main ': 


unittest.main() 


“Ye 


第 U1 章 ”WebDriver 高 级 应 用 


第 10 章 讲解 了 WebDriver 常用 API 的 使 用 方法 ,本 章 将 作为 WebDriver 进 阶 部 分 , 讲 


fit WebDriver 


器 


高 级 应 用 。 读 者 如 果 想 向 中 级 水 平 的 自动 化 测试 工程 师 靠 近 , 请 务必 掌握 本 


章 中 的 全 部 应 用 实例 。 


11.1 使 用 JavaScript 操作 页 面 元 素 


目的 : 


在 WebDriver 脚本 代码 中 执行 JavaScript 代码 ,来 实现 对 页 面 元 素 的 操作 。 此 种 方式 
主要 用 于 解决 在 某 些 情况 下 ,页 面 元 素 的 . clik() 方 法 无 法 生效 等 问题 。 
用 于 测试 的 网 址 : 


http://www. baidu. com 


实例 代码 : 


# encoding- utf - 8 
from selenium import webdriver 


from selenium. common. exceptions import WebDriverException 
import unittest 

import traceback 

import time 


class TestDemo(unittest.TestCase): 


def setUp(self): 
# 启动 Chrome Xj 4i a5 
self.driver = webdriver.Chrome(executable path = "c: Wchromedriver") 


def test executeScript(self): 


url 
# 访问 baidu 首页 

self.driver.get(url) 

# Hit JavaScript rft Fr IE Pj VOIE efi A fie D C3 (3 f 
searchInputBox]S = "document. getElementById('kw'). value = ' 光 荣 之 路 ';" 
# 构造 JavaScript Æ$ Fr HE PERCHE BLU FCRI HE UB 

searchButtonJS = "document.getElementByld('su').click()" 


try: 


= "http://www. baidu. com" 


# 通过 JavaScript fd fe Fi EE H VIA IE Cfi A fie rd A DURER REI 
self.driver.execute script(searchInputBoxJS) 
time. sleep(2) 
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# 通过 JavaScript 代码 单 击 百度 首页 上 的 搜索 按 纪 

self. driver. execute_ script(searchButtonJS) 

time. sleep(2) 

self.assertTrue(u" 百 度 百 科 " in self.driver.page source) 
except WebDriverException, e: 

# 当 定 位 失败 肝 , 会 搬出 WebDriverException E 3f 

print u" 在 页 面 中 没有 找到 要 操作 的 页 面 元素 ", traceback. print exc() 
except AssertionError, e: 

print u 页 面 不 存在 断言 的 关键 字 串 ” 
except Exception, e: 

5E RHH, TII TEE 


print traceback. print exc() 


def tearDown(self): 
# 退出 Chrome X w 8 
self. driver. quit() 


if _name_ == ' main ': 


unittest.main() 


11.2 BM :EE 


目的 : 

(1) 滑动 页 面 的 滚动 条 到 页 面 最 下 面 。 

(2) 滑动 页 面 的 滚动 条 到 页 面 的 某 个 元 素 。 

C3) 滑动 页 面 的 滚动 条 向 下 移动 某 个 数量 的 像素 。 
用 于 测试 的 网 址 : 


http://www. seleniumhq. org/ 


实例 代码 : 


# encoding = utf - 8 
from selenium import webdriver 
import unittest 

import traceback 

import tine 


class TestDemo(unittest. TestCase): 


def setUp(self): 
* 启动 Chrome Ù w d 
self.driver = webdriver.Chrome(executable path = "c: VW chromedriver") 


def test scroll(self): 
url = "http://www. seleniumhq. org/" 
£ 访问 selenium £f fj £f Jt 
try: 
self.driver.get(url) 
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使 用 JavaScript 的 scrollTo PR 3X fll document. body. scrollHeight 参数 
将 页 面 的 菠 动 条 将 动 到 页 面 的 最 下 方 
self.driver.execute script\ 

(" window. scrollTo(100, document. body. scrollHeight);") 
zOBH3E,HTA TEUER JA SBIBSITIEÓ S. 
# 根据 测试 需要 , UEREF AS E NE 
time. sleep(3) 


# [JI] JavaScript 的 scrollIntoView Pj C14 gti PER 26 3E 8: 24 I n] BE SE E 
# scrollIntoView(true) As H4 JU 3k iR 2 BE Ae P i] 
# scrollIntoView(false) IRH JU C iR B1 P) BERE ICE 
self. driver. execute_script\ 
(" document. getElementById( 'choice').scrollIntoView(true);") 
# BH 3 Eb, MFA TI UER h AAE A E y PIE E hY fy 
# 根据 测试 需要 , ERE F k hy P dC 
tine. sleep(3) 


# [JI] JavaScript 的 scrollBy 方法 ,使 用 0 和 400 WHALES, 
# 将 页 面 纵 向 向 下 党 动 400 RZ 
self. driver. execute Script(" window. scrollBy(0,400);") 
# BH 3 Eb, 用 于 人 工 验 证 菠 动 条 是 否 将 动 到 指 害 的 亿 置 . 
# ORENSE, TEE F ili D [HEC 
tine. sleep(3) 
except Exception, e: 
# TER WEBB 


print traceback. print exc() 


def tearDown(self): 
£ 退出 Chrome 浏览 天 


self.driver.quit() 


if nane  -- ' main ': 


unittest. main( ) 


更 多 说 明 : 
这 里 我 们 操作 页 面 滚动 条 的 方法 其 实 是 调用 JavaScript 方法 ,通过 这 种 方法 就 可 以 随 
意 操作 页 面 的 滚动 条 了 ,无 论 是 纵向 滚动 ,还 是 横向 滚动 。 


在 Ajax 方式 产生 的 浮动 框 中 , 单 击 选择 包含 某 个 


1.3 关键 字 的 选项 





目的 : 

有 些 被 测试 页 面包 含 Ajax 的 局 部 刷新 机 制 ,并 且 会 产生 显示 多 条 数据 的 浮动 框 ,需要 
单 击 选择 浮动 框 中 包含 某 个 关键 字 的 选项 。 

用 于 测试 的 网 址 : 


http://www. sogou. com 
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单 击 一 下 搜狗 首页 的 搜索 框 ,将 焦点 切换 到 搜索 输入 框 中 后 ,会 看 到 弹出 浮动 框 的 效 
果 , 如 图 11-1 所 示 。 








F 


ORIZ 
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浮动 框 选项 


s= 


KE o1 


第 一 种 方法 : 通过 模拟 键盘 下 箭头 进行 选择 悬浮 框 选 项 。 
实例 代码 : 


#encoding= utf - 8 

from selenium import webdriver 

from selenium. webdriver. common. keys import Keys 
import unittest 

import time 


class TestDemo(unittest. TestCase): 
def setUp(self): 


# 启动 Chrome j| w gs f 
self.driver = webdriver.Chrome(executable path = "c:\\chromedriver" ) II 





def test. AjaxDivOptionByKeys(self): LA 
url = "http://www. sogou. com/" 
# 访问 sogou 的 首页 
self.driver.get(url) 
# REHE I EE TPR AERE 
searchBox = self.driver.find element by id("query") 
# ERRA PMA" HRZ" 
searchBox. send keys(u" 3E 9& 2 8&" ) 
# PIF 2 Pb, UE CEP HE I ESE 
time. sleep(2) 
for i in range(3): 
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# DEFE EI ABUL AI BOB OE fE ia E DEBET HOL AK 

# BHURE GL d; RIA 

searchBox. send keys(Keys. DOWN) 

tine. sleep(0.5) 
# R FAE EFE MIE S, PERM RE GEHE ILE RE, 选中 该 选项 
searchBox. send keys(Keys. ENTER) 
time. sleep(3) 


def tearDown(self): 
# iB Hi Chrome Ù w d 
self.driver.quit() 


if name  -- ' main 


unittest.main() 


第 二 种 方法 : 通过 匹配 模糊 内 容 选 择 悬 浮 框 中 选项 。 
实例 代码 : 


# encoding = utf - 8 

from selenium import webdriver 

from selenium. common. exceptions import NoSuchElementException 
import traceback 

import unittest 

import time 


class TestDemo(unittest.TestCase): 


def setUp(self): 
# 启动 Chrome W Y 4 
self.driver = webdriver.Chrome(executable path = "c:\\chromedriver" ) 


def test AjaxDivOptionByWords(self): 
url = "http://www. sogou. com/" 
# 访问 sogou 的 首页 
self.driver.get(url) 
try: 
E BIO JU FECI DOO fil A Ml CITUR 
searchBox - self.driver.find element by id("query") 
# feda A fedi A ARZ" 
searchBox. send keys(u" J£ 9e Z R") 
# GIF 2 秒 , DUET TE I HC 
time. sleep(2) 
£F TEIL "MEERE UU TE EE 
suggetion option = self. driver.\ 
find element by xpath("//ul/1i[contains(.，' 篮 球 电 影 ')]") 
# 尝 击 找到 的 选项 
suggetion option.click() 
time. sleep(3) 
except NoSuchElementException, e: 
# FPDF R ERE 
print traceback. print exc() 


- 176.- 


def tearDown(self): 
# 退出 Chrome | Vi d 
self.driver.quit() 


if name  -- 
unittest.main() 


更 多 说 明 


main . 


因为 浮动 框 的 内 容 可 能 会 时 常 发 生变 化 ,如 果 只 想 固定 选择 浮动 框 中 的 某 一 项 ,比如 第 


三 项 ,可 以 参考 如 下 代码 : 


def test AjaxDivOptionByIndex( self): 
url = "http://www. sogou. com/" 
# 访问 sogou 的 首页 
self.driver.get(url) 
try: 


# HEIHEI PEUT edi A Te CIL TUR 


$1 x 


searchBox - self.driver.find element by id("query") 


# ERRA PA DEBE 


searchBox. send keys(u" 3E 9& Z") 


E EIF 2E, A MEE FREMRI 
time. sleep(2) 


# ARF aM dm, 只 要 更 改 1i[3] 中 的 策 引 | 数字, 


WebDriver 高 级 





# 就 可 以 实现 任意 单 击 选 项 浮动 奏 中 的 选项 .注意 , 筑 31 人 工 开始 


suggetion option = self. driver. 


\ 


find element by xpath("//* [@id= 'v1']/div[1]/ul/1i[3]") 


# Mili He PIY 
suggetion option.click() 
tine. sleep(3) 

except NoSuchElementException, e: 
# TIS WOEHITB 


print traceback.print exc() 


11.4 BEES TEES EUR pes 


目标 : 

通过 代码 关闭 浏览 器 进程 。 
Python 语言 实例 代码 : 

# encoding = utf - 8 


from selenium import webdriver 
import unittest 


class TestDemo(unittest. TestCase): 


def test killWindowsProcess(self): 


£ 启动 Firefox | w a 


firefoxDriver = webdriver.Firefox(executable path- "c: Wgeckodriver") 
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* RIEN 
ieDriver = webdriver.le(executable path = "c:VMIEDriverServer" ) 
# 启动 Chrome ÙY w d 
chromeDriver = webdriver.Chrome(executable path = "c: M chromedriver") 
# 5 A Python [fj os fu 
import os 
# fA Firefox DU Vi ap EE 
returnCode = os.system("taskkill /F /iM firefox. exe" ) 
if returnCode -- 0: 
print u" 成 功 结束 Firefox 浏览 器 进程 !" 
else: 
print u" 结 束 Firefox 浏览 器 进程 失败 !" 
Ë GAIE IE W WE Ae EFE 
returnCode = os.system("taskkill /F /iM iexplore. exe" ) 
if returnCode == 0: 
print u" 成 功 结束 IE ji] f se d FE!" 
else: 
print u" 结 束 IE 浏览 器 进程 失败 与 
# fW Chrome WY W dE EFE 
returnCode - os.system("taskkill /F /iM chrome. exe" ) 
if returnCode -- 0: 
print u" 成 功 结束 Chrome 浏览 器 进程 !" 
else: 


print u" 结束 Chrome 浏览 器 进程 失败 !" 


if name == ' main ': 


unittest. main() 


代码 说 明 : 

将 Windows 上 的 DOS 命令 的 字符 串 类 型 数据 作为 参数 值 传递 给 Python 语言 的 os. 
system(Ccommand) 函数 ,然后 该 函数 执行 该 DOS 命令 ,并 返回 执行 结果 码 (0 表示 命令 执行 
成 功 , 非 0 表示 命令 执行 失败 ) ,以 此 来 结束 Windows 中 的 浏览 器 进程 。 


11.5 MESE EP SE d: dedil 


目的 : 

掌握 设 定 页 面 对 象 的 所 有 属性 的 方法 ,本 节 以 设 定 文本 框 的 可 编辑 状态 和 显示 长 度 为 
目标 。 

用 于 测试 的 网 页 的 HTML 代码 : 


<html> 
X head» 
<title > 设置 文本 框 属性 </title> 
<meta http - equiv = "Content - Type" content = "text/html; charset = utf — 8" /> 
</head> 
<body> 
< input type= "text" id- "text" value= "今年 夏天 西瓜 相当 甜 !" size=100> 
文本 框 
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</input > 
</body> 
</html > 


实例 代码 : 


#encoding = utf - 8 
from selenium import webdriver 
import unittest 


def addAttribute(driver, elementObj, attributeName, value): 
# EER DUI TE TRAE "P S DLE ETE RO Zr A 
# 调用 JavaScript fC 46855 9 ilii bi 4 E Jr B TE, argunents[ 0] —arguments[2]7) 9] 2: JH fr lf AY 
# element,attributeName 和 value & Y (Ii VE f EH , JEHA fr iX JavaScript 代码 
# 添加 新 属性 的 JavaScript 代码 语法 为 : element.attributeName = value 
# 比如 input. nane = "test" 
driver.execute script("arguments[0]. %s=arguments[1]" $attributeName, 
elementObj, value) 


def setAttribute(driver, elementObj, attributeName, value): 
# 封装 设置 页 面 对 象 的 属性 值 的 方法 
* 调用 JavaScript (C631 9t lii jc XX lf] IB TE ff, arguments [0 ] —arguments[2 ] 4-8] £ HIS If fid 
# element,attributeName 和 value Z f (fi IT EF Ha, JEHA fT1E JavaScript 代码 
driver.execute script("arguments[0]. setAttributeV 
(arguments[1], arguments[2])", elementObj, attributeName, value) 


def getAttribute(elementObj, attributeName): 
# 封装 获取 页 面 对 象 的 必 性 值 的 方法 


return elementObj. get attribute(attributeName) 


def removeAttribute(driver, elementObj, attributeName): 
# OGBERBLER XUI TOC IR HERI rA 
# WII] JavaScript EAER XC Ili JEZ HY TE AE hY I FE , arguments [0 ] arguments [1] 4) 7] £ HET ilit 
# element,attributeName £T (f JE fT EF He, JEHA fT JavaScript 代码 
driver.execute script("arguments[0]. removeAttribute(arguments[1])", 
elementObj, attributeName) 


class TestDemo(unittest. TestCase): 


def setUp(self): 
* 启动 Chrome ji] w dr 
self.driver = webdriver.Chrome(executable path = "c: V chromedriver" ) 


def test dataPicker(self): 
url = "d:WoperateAttribute. html" 
# 访问 自 定义 网 页 
self.driver.get(url) 
# 我 到 页 面 上 标签 名 为 input 的 页 面 元 素 
element = self.driver.find element by xpath("//input") 
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# AHX input 标签 中 添加 新 属性 name = "search" 
addAttribute(self.driver, element, 'name', "search") 

# 浴 加 新 属性 后 ,查看 一 下 新 添加 的 属性 

print u' 添 加 的 新 属性 值 和 $s="%s"' $$ ("name", getAttribute(element, "name")) 


# AA kX HE input 标签 的 value R tE fii 
print u" 更 改 文本 框 中 的 内 容 前 的 内 容 : ", getAttribute(element, "value" ) 
# 更 改 input 页 面 无 素 的 value 属性 值 为 "这 是 更 改 后 的 文字 内 众 "” 
setAttribute(self.driver, element, "value", u" 这 是 更 改 后 的 文字 内 容 " ) 
# 更 改 input 页 面 无 素 的 value 属性 位 后 ,再 次 查看 其 value Jg HE fii 

print u" 更 改 文本 框 中 内 容 后 的 内 容 : ", getAttribute(element, "value") 


# 得 看 修改 前 文本 故 input 页 面 无 素 中 的 size BTE 

print uw" 更 改 前 文本 框 标签 中 的 size 属性 值 : ", gethttribute(element, "size") 
# 更 改 input 页 面 无 素 的 size I PE (fi 2 "20" 

setAttribute(self.driver, element, "size", 20) 

# Eik input Wi JC XX I] size JB PETIT, BE EEUU size 属性 值 

print u" 更 改 后 文本 框 标签 中 的 size RIEA: ", getAttribute(element, "size") 


# 查看 删除 input 页 面 无 素 value 属 人 性 所 value 属性 得 

print u" 文 本 框 value 属性 值 : ", getAttribute(element, "value" ) 

# BER X cfle il) value [ift 

removeAttribute(self.driver, element, "value") 

# MER X AK HE I value BET, BE TET. value IR HE fii 

print u" 删 除 value 属性 值 后 value 属性 值 : ", gethttribute(element, "value") 


def tearDown( self) : 
# 退出 Chrome W W 8E 
self. driver. quit() 


if _name_ == 
unittest. main( ) 


输出 结果 : 


添加 的 新 属性 值 name = "search" 

更 改 文本 框 中 的 内 容 前 的 内 容 : 今年 夏天 西瓜 相当 甜 ! 
更 改 文本 框 中 内 容 后 的 内 容 : 这 是 更 改 后 的 文字 内 容 
更 改 前 文本 框 标签 中 的 size 属性 值 : 100 

更 改 后 文本 框 标签 中 的 size 属性 值 : 20 

文本 框 value 属性 值 : 这 是 更 改 后 的 文字 内 容 

删除 value 属性 值 后 value 属性 值 : 


本 节 实 例 针 对 页 面 元 素 属性 的 新 增 、 更 改 、 查 询 以 及 删除 都 是 临时 的 ,只 针 
对 当前 会 话 有 效 , 页 面 源码 并 没有 被 真正 修改 。 





本 实例 在 下 浏览 器 上 可 能 实验 不 成 功 ,因为 IE 浏览 器 经 常 存在 JavaScript 兼容 性 
问题 。 
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11.6 Epp IESU E 某 个 文件 





目的 : 

在 网 页 上 下 载 文 件 时 ,通常 需要 人 为 设 定 下 载 文件 并 选择 保存 路 径 , 这 样 就 无 法 实现 完 
全 自动 的 下 载 过 程 。 下 面 的 例子 实现 了 基于 Firefox 浏览 器 的 全 自动 化 文件 下 载 操 作 , 肢 
本 执行 后 会 将 文件 自动 保存 到 指定 目录 的 文件 夹 下 。 

用 于 测试 的 网 址 : 


https ://www. python. org/downloads/release/python — 2712/ 
https://github. com/nozilla/geckodriver/releases 


实例 代码 : 


# encoding - utf - 8 
from selenium import webdriver 
import unittest, time 


class TestDemo(unittest.TestCase): 


def setUp(self): 

# 创建 一 个 FirefoxProfile 实例 ,用 于 存放 月 定义 配置 

profile = webdriver.FirefoxProfile() 

# E FRE, BURS A EH A R, MRI T 

# 多 级 不 存在 的 月 灵 , 将 会 下 载 到 默认 路 径 

profile. set_preference( 'browser. download. dir', 'd:\\iDownload') 

# 将 browser. download. folderList 设置 为 2, 表示 将 文件 下 载 到 指定 路 径 

# 设置 成 2 表示 使 用 有 自 定义 下 载 足 径 ; 

# 设置 成 0 表示 下 载 到 桌面 ; 变 置 成 1 表示 下 载 到 默认 路 径 

profile. set_preference( 'browser. download. folderList', 2) 

# browser. helperApps. alwaysAsk. force 对 于 未 知 的 MIME 类 型 文件 会 弹出 窗口 

# 让 用 户 处 理 , BRUH True, HEN False 表示 不 会 记录 打开 未 知 MIME 类 型 

# 文件 的 方式 

profile. set_preference("browser. helperApps. alwaysAsk. force", False) 

# 在 开始 下 载 时 县 否 显 示 下 载 管理 器 

profile.set preference( 'browser. download. manager. showWhenStarting', 
False) 

# BUE False fU RAE ULITISUR 

profile. set_preference(" browser. download. manager. useWindow', False) 

# BUA True, HEX False 表示 不 获取 焦点 

profile. set_preference(" browser. download. manager. focusWhenStarting", 
False) 

# FE. exe XIF ih BEES, 上 默认 从 是 True, WEH False MA Ze PB IRE E 

profile. set_preference(" browser. download. manager. alertOnEXEOpen" , 
False) 

# browser. helperApps. neverAsk. openFile IR HIH H FRX, Af lb ll iA fe 

# BGB SEHBB, FITI TE T S PEXE MIME 类 型 ， 

# 例如 application/exe, 表示 . exe 类 型 的 文件 , 

# application/excel 表示 Excel 类 型 的 文 作 
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profile.set preference("browser. helperApps. neverAsk. openFile" , 
"application/pdf" ) 

# AINEA HI XAFRA! AR BET HI EUR fle ETT TRI IS], 直 失 保存 到 本 地 磁盘 

profile.set preference( 'browser.helperApps. neverAsk. saveToDisk', 
'application/zip, application/octet - stream') 

# browser. download. manager. showAlertOnConplete E FR X ÍT ZA fü pi EAR F 

2 REMER, 默认 为 True, 设 定 为 False AUR T AURIS T ER T Mo Boni 

profile.set preference(" browser. download. manager. showAlertOnComplete" , 
False); 

# browser. download. manager. closeWhenDone if ;E F X4 kk iJ i ELS 

# XA FUE, BU MH True, WEH False 表示 不 关闭 下 载 管理 带 

profile. set_preference("browser. download. manager. closeWhenDone" , 
False) 


RPSL WARN, firefox profile 参数 

# M E s Bo PLUS Jl Sl FirefoxProfile 对 象 中 

self.driver = webdriver.Firefox(executable path="c:\\geckodriver", 
firefox profile - profile) 


def test dataPicker(self): 
* 访问 WebDriver JĘZ} Firefox 的 驱动 文 作 下 载 网 址 
urll = "https://github. com/mozilla/geckodriver/releases" 
self.driver.get(urll) 
# FEFE ZIP 类 型 文件 ,使 用 application/zip 指 代 此 类 型 文件 
self.driver.find element by _xpath\ 

('//strong[. = "geckodriver- v0.11.1 - win64. zip" ]').click() 

# ÉRIC AXE 


time. sleep(10) 


# 访问 Python 2.7.12 文件 下 载 页 面 , 下 载 扩 展 名 为 msi 的 文件 
# fJ application/octet - stream 夹 指 明 此 类 文件 类 型 
url = "https://www. python. org/downloads/release/python - 2712/" 
self.driver.get(url) 
# 找到 Python 2. 7.12 下 载 页 面 中 链接 文字 为 "Windows x86 — 64 MSI installer" 
# 的 链接 页 面 元 素 , Mii TEAT F HHY FE Python 2.7.12 E FEE XIF 
self.driver.find element by link textV 

("Windows x86 - 64 MSI installer").click() 
E BIEX IF FEE, ARE ELIO I HE EAE DO BEE SE FE A AS F T 
time. sleep(100) 


def tearDown(self): 
self. driver. quit() 


' main ': 


if name  -- 
unittest.main() 


代码 解释 : 

通过 profile. set_preference('browser. helperApps. neverAsk. saveToDisk'. 'xxxx')iX 
种 方式 添加 需要 屏蔽 下 载 询问 弹出 的 文件 类 型 ,如果 要 同时 添加 多 种 文件 类 型 ,文件 类 型 间 
用 逗号 隔 开 ,如 本 例 中 的 “application/zip, application/octet-stream”。 
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更 多 说 明 : 
请 访问 http://www. w3school. com. cn/media/media mimeref. asp 查看 更 多 的 文件 类 
型 及 解释 。 


11.7 Ee eE 


本 节 主 要 介绍 通过 程序 代码 无 人 工 干预 地 上 传 文件 附件 ,并 进行 提交 操作 。 
11.7.1 使 用 WebDriver 的 send_keys 方法 上 传 文件 





目的 : 

使 用 send. keys 方法 上 传 一 个 文件 附件 ,并 进行 提交 操作 。 
用 于 测试 的 网 页 的 HTML 代码 : 

<html> 

« head » 


«title» E f£ X fF«/title» 
«neta http - equiv = "Content - Type" content = "text/html; charset = utf - 8" /> 
</head> 
< body> 
< form enctype = "multipart/form - data" action= "parse file. jsp" method = "post"> 
<p> Browse for a file to upload: </p> 
« input id="file" name - "file" type= "file"></input > 
<br/><br/> 
«input type = "submit" id= "filesubmit" value = "SUBMIT"></input> 
</form> 
</body> 
</html > 


由 于 篇 幅 所 限 ,这 里 就 不 给 出 parse. file. jsp 的 源 代码 。 上 传 文件 成 功 后 ,会 跳 转 到 
parse file. jsp 页 面 , 此 页 面 的 Title 显示 为 “文件 上 传 成 功 ”。 
实例 代码 : 


#encoding= utf - 8 
from selenium import webdriver 

import unittest 

import time 

import traceback 

from selenium. webdriver. SUpport. ui import WebDriverWait 

from selenium. webdriver. common. by import By 

from selenium.webdriver.Support import expected conditions as EC 

from selenium. common. exceptions import TimeoutException, NoSuchElementException 


class TestDemo(unittest. TestCase): 
def setUp(self): 


# 启动 Chrome Ù) Vi 8E 
self.driver = webdriver.Chrome(executable path = "c: Wchromedriver") 
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def test uploadFileBySendKeys( self): 
url = "d:\\uploadFile. html" 
# 访问 月 定义 网 页 
self.driver.get(url) 
try: 
# 创建 一 个 显 式 等 符 对 象 
wait = WebDriverWait(self.driver, 10, 0.2) 
# CENAA B IER ETE LH E PC TEE HL BEAT TEE es 
wait. until(EC.element to be clickable((By. ID, 'file'))) 
except TimeoutException, e: 
# 捕获 TimeoutException 5 af 
print traceback. print exc() 
except NoSuchElementException, e: 
# 捕获 NoSuchElementException 5 jf 
print traceback. print exc() 
except Exception, e: 
# 捕获 其 他 异常 
print traceback. print_exc() 
else: 
# AIHE IDEEA "File" hh XC E EHE 
fileBox = self. driver. find element by id("file") 
# dEXTE E EHE KY BEIGE I fh A ZEE PEHY X fTHEÉG "c: V test. txt" 
fileBox. send_keys("c:\\test. txt") 
# BREA EEK XI 
time. sleep(4) 
# 找到 页 面 上 ID I HEH "filesubmit" hy XC lE 36 T MIR 
fileSubmitButton = self.driver.find element by id("filesubmit") 
A Milite t, SEXT E fEBHE 
fileSubmitButton.click() 
# BI XIE NERZH, Br DL ix E np ELI M S CA ARS, 
# ONIBESCTE E PERI ESL DII IE SPESE] CE E PE CIIM E BI. 
# 通过 EC. title is() Jr HIE BERE IR I VEI Title 
# dH dit a M, AUR VE AHE IESE WIT I EN 


# AA SH I parse file. jsp Jt ij, JF H T DL I 9j Wife, 
# DUUM F IEOR E FE, Biz CE E ERIH 
# wait.until(EC.title is(u" X fF EEMI ")) 


def tearDown(self): 
# 退出 Chrome Ji] i ds 
self.driver.quit() 


if name  -- main |. 


unittest.main() 


11.7.2. 模拟 键盘 操作 ,实现 上 传 文件 


目的 : 
通过 模拟 键盘 按键 操作 来 完成 文件 上 传 功能 。 
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用 于 测试 网 页 的 HTML 代码 : 
被 测试 网 页 的 HTML 代码 同 11.7.1 节 。 
实例 代码 : 


# encoding = utf - 8 

from selenium import webdriver 

import unittest 

import time 

import traceback 

import win32clipboard as w 

import win32api 

import win32con 

from selenium. webdriver. support. ui import WebDriverWait 

from selenium. webdriver.common.by import By 

from selenium. webdriver. support import expected conditions as EC 
from selenium. common. exceptions import TimeoutException, NoSuchElementException 


eH TENRENM RIT 
def setText(aString): 
w. OpenClipboard() 
w. EmptyClipboard( ) 
w. SetClipboardData(win32con.CF UNICODETEXT, aString) 
w. CloseClipboard() 


# 键盘 按键 映射 字典 

VK CODE = ( 
'enter':Ox0D, 
'etrl':0xll, 
'v':0x56) 


# ÓHAREF 
def keyDown(keyName) : 
win32api.keybd event(VK CODE[keyName], 0, 0, 0) 
A flitet 
def keyUp(keyName) : 
win32api.keybd event(VK CODE[keyName], 0, win32con. KEYEVENTF_KEYUP, 0) 


class TestDemo(unittest. TestCase): 


def setUp(self): 
£ 启动 Chrome tj Vi ds 
self.driver = webdriver.Chrome(executable path = "c: chromedriver") 


def test uploadFileByKeyboard(self): 
url = "d:WuploadFile. html" 
# Wl HAEX 


self.driver.get(url) 


try: 
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# Bg — T gx FFR 
wait - WebDriverWait(self.driver, 10, 0.2) 
# 星 式 等 待 判 断 设 测试 页 面 上 的 上 传 文件 按 所 是 否 处 于 可 被 单 击 状态 
wait.until(EC.element to be clickable((By. ID, 'file'))) 
except TimeoutException, e: 
# 捕获 TimeoutException 异常 
print traceback. print exc() 
except NoSuchElementException, e: 
# 捕获 NoSuchElementException 5f 
print traceback. print exc() 
except Exception, e: 
# MICE AF 
print traceback. print exc() 
else: 
# KBIEEE E ME hY KIER BEI i PE P DI RE fne 
setText(u"c:W test. txt" ) 
# o: E IDIR HEH "Eile" M x fT EfEfE, 
# JEA ihi W ih EFE MEE feft 
self. driver. find element by id("file").click() 
time. sleep(2) 
# BUR HET Ctrl + VARRE 
keyDown(" Ctr1") 
keyDown(" V" ) 
# BELFER Ctrl + vif 
keyUp(" V" ) 
keyUp(" Ctrl") 
time. sleep(1) 
# BEREE FIERE 
keyDown(" enter" ) 
# BHURE EROR ET T fit 
keyUp(" enter" ) 
# We EEM XI 
tine. sleep(2) 
* RPTE ID JH TERT Y filesubnit 的 文件 提交 按 纽 对 和 象 
fileSubmitButton - self.driver.find element by id("filesubmit") 
End ETE, S OT EfEBME 
fileSubmitButton.click() 
# Bi XE E fei EI IW], Br DA UB np ARMER REAR, 
# NICHE E PERI es, CIE IE BEREICHE E PE aR I I T iT- 
# 通过 EC. title is() JAAIBEBERE TIRE ÁY Title 
# dH Bw I, 如果 匹配 将 继续 执行 后 续 代 码 
£ wait.until(EC.title is(u" 文 件 上 传 成 功 ")) 


def tearDown( self): 
# 退出 Chrome j| w di 
self.driver.quit() 


if name  -- main 


unittest.main() 
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11.7.3. 使 用 第 三 方 工具 Autolt. 上 传 文件 


目的 : 

能 使 用 第 三 方 工具 Autolt 操作 一 些 WebDriver 无 法 操作 的 文件 上 传 对 象 。 

用 于 测试 网 页 的 HTML 代码 : 

被 测试 网 页 的 HTML 代码 同 11.7.1 节 。 

Autolt 工具 的 安装 方法 : 

(D 访问 https://www. autoitscript. com/ site/autoit/downloads/ 网 址 ,下 载 Autolt T. 
具 , 如 图 11-2 所 示 。 





Software Download 


Autolt Full Installation. includes x86 and x64 components, and 
*  Autolt program files, documentation and examples. 


* Aut2Exe - Script to executable converter. Convert your scripts into standalone exe Miili FER 
files! 

*  AutoltX - DLL/COM control. Add Autolt features to your favorite programming and 

scripting languages! Also features a C& assembly and PowerShell CmdLets. 


* Editor -A cut down version of the SCTE script editor package to get started. Download 


the package below for the full version! 
图 11-2 
(2) Autolt 软件 下 载 成 功 后 ,会 得 到 一 个 扩展 名 为 . exe 的 文件 ,双击 该 文件 进行 安装 。 
G) 双击 exe 文 件 后 ,将 显示 如 图 11-3 所 示 的 界面 , 单 击 Next 按钮 。 


£D Autolt v3.3.142 Setup EO I 


Welcome to the Autolt v3.3.14.2 
Setup Wizard 








This wizard will guide you through the installation of Autolt 
93.3.14.2. 


1t is recommended that you close all other applications 
before starting Setup. This will make it possible to update 
relevant system files without having to reboot your 
computer. 


Click Next to continue. 


"iti 











` 
[Ce] m1 
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Please review the license terms before installing Autolt 


Press Page Down to see the rest of the agreement. 


Autor 


Author — : Jonathan Bennett and the Autot Team 





Agreement ("EULA") is a legal agreement 
boton yes Celfus rebane merk Area a mam em a 

f you accept the terms of the agreement, click 1 Agree to continue. You must accept the 
agreement to install Auto v3.3.14.2. 


Nullsoft install System v2.46 








(5) 然后 一 直 单 击 Next 按钮 ,直到 出 现 如 图 11-5 所 示 的 界面 ,设置 好 文件 即将 安装 的 
路 径 , 然 后 单 击 Install 按钮 ,开始 安装 。 





Choose the folder in which to install Autolt v3.3.14.2. 


Setup will install AutoR v3.3.14.2 in the following folder. To install in a different folder, dick 
Browse and select another folder. Click Install to start the installation. 


选择 文件 要 安装 的 路 径 





Space required: 31.1MB 
Space available: 29.368 





Nullsoft Install System v2.46 


(6) 等 待 安装 的 进度 条 走 完 ,将 出 现 如 图 11-6 所 示 的 界面 , 单 击 Finish 按钮 ,完成 所 有 
安装 步骤 。 

(7) 从 https://www. autoitscript. com/site/autoit/downloads/ 网 址 上 下 载 Autolt 的 
编辑 器 ,如 图 11-7 和 图 11-8 所 示 。 

(8) 下 载 完 后 将 会 得 到 一 个 [SEEAaGiae 本 文件 ,双击 该 文件 进行 安装 ,一 直 单 击 
Next 按钮 ,直到 出 现 如 图 11-9 所 示 的 界面 , 单 击 I Agree 按钮 进行 正式 安装 。 
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Completing the Autolt v3.3.14.2 
Setup Wizard 


Autolt v3.3.14.2 has been installed on your computer. 


Click Finish to close this wizard. 


网 Show release notes (check for script breaking changes) 


单 击 完成 安装 


Visit the Autolt website for news and support. 








图 11-6 
Autolt Script Editor (Customised version of SCITE with lots of additional coding tools for 
Autom 单 击 该 技 钮 ， 将 跳 转 到 下 载 页 面 
图 11-7 


Autolt Script Editor Downloads 


Current Versions 

















Date 


vpdated Utas 








12-6- Installer containing SciTE and all configuration files plus 
bote jutilities.Update History, Definition files included: Autolt 
[ 3.3.14. 2 and BETA v3.3.15. 0 





























Pama ——————— 上 Ry 


Press Page Down to see the rest of the agreement. 





[License for Scintilla and SCTE n 


|Copyright 1998-2003 by Ned Hodgson «neih& santila org» 





Y you accept the terms of the agreement, click 1 Agree to continue. You must accept the 
agreement to intal STEAM IE 6211192.— ge niei 
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O) 待 安装 进度 条 走 完 , 将 出 现 如 图 11-10 所 示 的 界面 , 单 击 Finish 按钮 ,完成 AutoIt 
脚本 编辑 器 的 安装 。 


@ sciTEAAutolt3 1661211190 sup [EE 


SciTE4Autolt3 install finished 











Installation of SGTE editor v 3.6.6.0 and all extra 
Components is 

Use CrlyFl in SaTE to read the information on how to get 
started. 


Enjoy. 





Cancel 








编辑 操作 文件 上 传 框 体 的 Autolt 脚本 : 

CD 执行 “开始 ”>“ 所 有 程序 ”>Autolt v3 Sci TE- Sci TE 命令 ,启动 Autolt 的 文本 
编辑 器 。 

(2) 在 编辑 器 中 输入 如 下 脚本 : 


* include < Constants. au3 > 


Send("c:\test. txt") 

Send(" {ENTER}" ) 

Send(" (ENTER)" ) 

脚本 解释 : 

Send( "c; \test. tx ) 表 示 使 用 键盘 输入 *c:\test. txt”。 

Send("{ENTER)") 表 示 按 Enter ££, 

调用 两 次 Enter 键 ,主要 是 解决 某 些 操作 系统 默认 的 输入 法 是 中 文 输入 法 ,输入 “ce:\ 
test, txt” 以 后 ,必须 按 一 下 Enter 键 才 能 将 输入 的 内 容 写 人 路 径 输 入 框 中 ,再 按 一 次 Enter 
键 ,就 等 价 于 单 击 文件 打开 窗 体 的 “打开 ”按钮 。 

G) 将 Autolt 脚本 保存 为 文件 名 为 “test. au3” 的 文件 并 存放 在 D 盘 驱 动 器 中 。 

(4) 执行 “开始 ”一 “所 有 程序 ”>Autolt v3 一 Compile script to. exe(x64) (根据 自己 的 
操作 系统 位 数 选择 正确 的 位 数 ), 调 出 将 Autolt 脚本 转换 成 exe 文件 的 界面 ,如 图 11-11 
所 示 。 

(5) 在 Source 路 径 框 中 选择 上 面 保存 的 Autolt 脚本 “test. au3” 文 件 , Destination 处 选 
TÉ. exe 单 选项 ,并 在 接 下 来 的 输入 框 中 设置 好 生成 exe 文件 的 保存 路 径 , 其 他 默认 即 可 。 

(6) 单 击 Convert 按钮 ,将 会 把 Autolt 脚本 “test. au3” 文 件 转换 成 “test. exe” 可 执行 文 
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A@1999-2015 Jonathan Bennett & AutoR Team 


http://veww.autoitscript.com/autoit3/ 


Files 
Source (Autolt au3) 


Destination (.exe/a3x) @ exe 


Options 
Custom Icon (co 





Compile for System — [V]xs4 











图 11-11 


ff Witestexe . 


使 用 Autolt 脚本 上 传 文件 的 实例 代码 : 


# encoding = utf - 8 

from selenium import webdriver 

import unittest 

import time, os 

import traceback 

from selenium. webdriver. support. ui import WebDriverWait 

from selenium. webdriver. common. by import By 

from selenium. webdriver. support import expected conditions as EC 

from selenium. common. exceptions import TimeoutException, NoSuchElementException 


class TestDeno(unittest. TestCase) : 


def setUp(self): 


# 启动 Chrome ji] W ds 
self.driver = webdriver.Chrome(executable path = "c: WW chromedriver") 


def test uploadFileByAutoIt(self): 

url = "d:WuploadFile. html" 

# 芒 问 请 定义 网 页 

self.driver.get(url) 

try: 
# 创建 一 个 显 式 等 莉 对 条 
wait = WebDriverWait(self.driver, 10, 0.2) 
# OSCAR ADHIBERI t T E EU E fe C PEE ILE ABT TREE d As 
wait. until(EC.element to be clickable((By. ID, 'file'))) 

except TimeoutException, e: 
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# 捕获 TimeoutException 异常 
print traceback. print exc() 
except NoSuchElementException, e: 
# 捕获 NoSuchElementException 53$ 
print traceback. print exc() 
except Exception, e: 
E 捕获 其 他 异 篇 
print traceback. print exc() 
else: 
zo: E IDIR HEH "tile" x ff Efefie, 
E IEA ili TEXTE Efefte 
self.driver.find element by id("file").click() 
# 通过 Python 提供 的 os Be If] system 方法 执行 生成 的 test. exe 文件 
os. system("d:\\book\\test. exe" ) 
# 由 于 AutoIt HA FE ei AY UT A (T XC fF. test. exe 可 能 热 行 速度 比较 爆 ， 
# 这 里 等 攻 5 Fh, 以 确保 test. exc 脚本 执行 成 功 
time. sleep(5) 
# 我 到 页 面 上 ID 属 性 值 为 "filesubmit" 的 文件 提交 按 纪 对 象 
fileSubmitButton = self.driver.find element by id("filesubmit") 
E Milite teth, ux FE tet NE 
fileSubmitButton.click() 
# ARAXE NEm SEHE RI, Pr EL E np ELS M d CP RR OR, 
# FUB X VEE PEAR Dei, DT i TE AS PETER XC E E fe DI 9C IBI. 
# 通过 EC. title is( ) Jr iX HIE BERE E B3 DUI] Title 
E 从 是 否 答 合 期望, 如 时 匹配 将 继续 执行 后 缕 代 码 
wait.until(EC.title is(u" 文 件 上 传 成 功 ")) 





def tearDown(self): 
# 退出 Chrome Ùy W ds 
self. driver. quit() 


if _name_ == ' main ': 


unittest. main() 


更 多 说 明 : 

本 实例 中 ,尽管 在 browser. helperApps. neverAsk, saveToDisk 参数 中 添加 了 所 有 类 型 
的 文件 ,但 仍 有 部 分 类 型 文件 不 生效 (比如 . exe 类 型 文件 ) ,针对 这 少 部 分 类 型 文件 的 下 载 
请 参看 11. 8 节 所 介绍 的 “右键 另存 为 下 载 文件 ”。 

关于 AutoltScript 的 编写 ,请 访问 https://www. autoitscript. com/autoit3/scite/docs/ 
SciTE4 Autolt3. html 进行 学 习 。 


11.8 MESE EESE SA 


目的 : 
能 够 模拟 实现 在 下 载 链接 上 直接 单 击 右键 另存 为 下 载 某 文件 的 功能 ,来 解决 通过 11. 6 
节 中 对 部 分 类 型 文件 下 载 不 能 生效 的 问题 ,本 节 以 . exe 类 型 的 文件 下 载 为 例 。 
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用 于 测试 的 网 址 : 
http://ftp. mozilla. org/pub/mozilla. org//firefox/releases/35. 0b8/win32/zh- CN/ 


AutoltScript 文件 准备 : 
新 建 一 个 名 为 loadFile. au3 的 AutoItScript 编辑 器 ,文件 具体 内 容 如 下 : 


;ControlFocus("title","text" ,controlID) 

;表示 将 焦点 切换 到 标题 为 title 窗 体 中 的 controlID 上 

jEdit 表示 第 一 个 可 以 编辑 的 实例 

;title 表示 弹出 的 Window 窗口 标题 ,不 同 浏览 器 的 标题 可 能 不 一 样 
ControlFocus( "请 输入 要 保存 的 文件 名 ...","", " Editl") 


;等 待 10 秒 以 便 Window 窗口 加 载 成 功 
WinWait("[CLASS: & 32770]", "", 10) 


;将 焦点 切换 到 Editi 输入 框 中 
ControlFocus(" 5] ff Jg", "", "Editl") 


;等 待 2 秒 
Sleep(2000) 


;将 要 下 载 的 文件 名 及 路 径 写 人 Editi 编辑 框 中 
ControlSetText(" 另 存 为 ",""，"Editl"，"d:NiDownloadNFirefox Setup 35. 0b8. exe") 


Sleep(2000) 


; 单 击 窗 体 中 的 第 一 个 按钮 ,也 就 是 保存 按钮 
ControlClick("5j ff Jg", "", "Buttonl") 


保存 后 将 该 文件 编译 成 exe 文件 ,并 存放 到 本 地 磁盘 。 
实例 代码 : 


# encoding- utf -8 

from selenium import webdriver 

import unittest, time, os 

from selenium. webdriver. common. keys import Keys 
from selenium. webdriver import ActionChains 
import win32api 

import win32con 


VK CODE = ('enter':0x0D, 'down arrow':0x28] 


# fet EHE F 
def keyDown(keyName) : 
win32api.keybd event(VK CODE[keyName], 0, 0, 0) 
ZH ERHEE 
def keyUp(keyName) : 
win32api.keybd event(VK CODE[keyName], 0, win32con. KEYEVENTF KEYUP, 0) 


class TestDemo(unittest. TestCase): 


=“ $93. - 
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def setUp( self) : 


self.driver = webdriver.Chrome(executable path="c:\\chromedriver") 


def test dataPickerByRightKey(self): 


-CN/" 


# 定义 将 要 芒 问 的 网 丰 
url = "http://ftp. mozilla. org/pub/mozilla. org//firefox/releases/35. 0b8/win32/zh 


self.driver.get(url) 
# 将 窗口 最 大 化 
self.driver.maximize window() 
* 暂停 5 敌 , 月 的 是 防止 页 面 有 一 些 多 余 的 草丛 占据 焦点 
time. sleep(5) 
* 找到 文本 内 众 为 "Firefox Setup 35. 0b8. exe" hh I fi IICK 
a = self.driver.find element by link text("Firefox Setup 35.0b8. exe") 
time. sleep(2) 
# FETERIBSEEBOURE E BUILT ii BU fr, 
* DUBBI HI ETE" FE OU "EHE RUE 
ActionChains(self.driver).context click(a).perform() 
# PIS 2T, T TK 
time. sleep(2) 
for i in range(4): 
# MIRE 4 次 下 租 头 ,将 焦点 切换 到 "另存 为 "选项 上 
# 不 同 浏览 如 此 选项 的 位 置 可 能 不 同 
a. send keys(Keys. DOWN) 
keyDown(" down arrow") 
keyUp(" down arrow") 
print i 
time. sleep(2) 
time. sleep(2) 
E GAREA "EIE E, BEL IE f 
# 调 出 保存 下 载 文件 路 径 的 Windows fj ffc 
keyDown(" enter" ) 
keyUp(" enter" ) 
time. sleep(3) 
# 通过 执行 AutoIt G IU Bé MERE ÁY Windows X Hfg fe BITE 
# 完成 文件 保存 路 径 的 设置 
os. systen(" d: \\book\ \ loadFile. exe" ) 
# OEREOCE FEER, MR E FE ELIO FI HET TE DO GEE EHE A GUT Hn] 
time. sleep(100) 


def tearDown(self): 


if name = 
unittest.main() 





self.driver.quit() 


- ' main ': 


本 例 提供 的 AutoltScript 脚本 仅 针对 Chrome 浏览 器 ,如 想 使 用 其 他 浏览 
器 ,需要 根据 具体 浏览 器 的 情况 修改 脚本 ,因为 不 同 浏览 器 调 出 的 保存 文件 窗 
体 标题 不 一 样 ,同时 保存 下 载 文 件 的 选项 索引 号 也 不 一 致 。 
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目的 : 
能 够 在 日 期 控件 上 进行 任意 年 .月 .日 的 选择 。 
用 于 测试 的 网 址 : 


http://jqueryui. com/resources/demos/datepicker/other - months. html 


由 于 被 测试 网 站 是 国外 的 ,有 可 能 会 出 现 访问 不 稳定 的 情况 ,如 有 条 件 请 使 用 相关 网 络 
代理 工具 。 被 测试 网 页 中 的 日 期 选择 控件 效果 如 图 11-12 所 示 。 


Date [ B B 
o November 2016 o 


Su Mo TH We Th Fr Sa 


图 11-12 
操作 日 期 选择 控件 的 实例 代码 : 


#encoding= utf -8 

from selenium import webdriver 

import unittest, time, traceback 

from selenium. webdriver. support. ui import WebDriverWait 

from selenium. webdriver. common. by import By 

from selenium. webdriver. support import expected conditions as EC 

from selenium. common. exceptions import TimeoutException, NoSuchElementException 


class TestDemo(unittest. TestCase): 


def setUp(self): 
# 启动 Chrome Dij Vi d 
self.driver = webdriver.Chrome(executable path = "c: VW chromedriver" ) 


def test datePicker(self): 
url = "http://jqueryui.com/resources/demos/datepicker/other - months. html" 
# 访问 指定 的 网 址 
self.driver.get(url) 
try: 
# 创建 一 个 星 式 等 竺 对 和 象 
wait = WebDriverWait(self. driver, 10, 0.2) 
E EIRA Ib BERI IX T AT E B0 H HIR A HE 48 n] LE H RE EA ili 
wait.until(EC.element to be clickable((By.ID, 'datepicker'))) 
except TimeoutException, e: 
# hI TimeoutException 异常 
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print traceback. print exc() 

except NoSuchElementException, e: 
# 捕获 NoSuchElementException 53$ 
print traceback. print exc() 

except Exception, e: 
E MEHR K 
print traceback. print_exc() 

else: 
# AFE AEE JUI E B9 H Ah A FE TCZ 
dateInputBox = self.driver.find element by id("datepicker") 
*OIESIH Jd A E, CBE A EE NECS HFFR 
* 就 可 以 变相 模拟 在 日 期 控件 上 进行 选择 本 
dateInputBox. send_keys("11/24/2016") 
time. sleep(3) 


def tearDown(self): 
# 退出 Chrome Ù w a 


self. driver. quit() 


if _name_ == ' main ': 
unittest.main() 
上 面 被 测试 网 页 中 的 日 期 控件 支持 输入 ,但 有 时 候 会 遇 到 日 期 选择 控件 不 
ES 允许 用 户 输入 的 情况 ,此 种 情况 下 可 以 通过 JavaScript 语句 改变 页 面 元 素 属性 
(EBD 值 的 方式 将 日 期 控件 修改 成 可 编辑 状态 , 以便 完 成 脚本 直接 输入 日 期 来 进行 日 
期 选择 ,具体 代码 请 参阅 11.5 节 说 明 。 


11.10 MzpuE EB Dey 





目的 : 

由 于 WebDriver 启动 Firefox 浏览 器 时 会 启用 全 新 的 Firefox 浏览 器 窗口 ,导致 当前 机 
器 的 Firefox 浏览 器 已 经 配置 的 信息 在 测试 中 均 无 法 生效 ,例如 已 经 安装 的 浏览 器 插件 、 个 
人 收藏 夹 等 。 为 了 解决 此 问题 ,自动 化 测试 脚本 中 需要 使 用 指定 的 配置 信息 来 启动 Firefox 
浏览 器 窗口 。 

生成 用 户 自 定义 的 Firefox 浏览 器 配置 文件 : 

CD 单 击 桌面 左下 角 的 Windows 图 标 , 在 “搜索 程序 和 文件 "输入 框 中 输入 “cmd”, 并 按 
Enter 键 ,以 便 调 出 CMD 控制 台 。 

(2) Æ CMD 中 使 用 cd 命令 进入 firefox. exe 文件 所 在 目录 (比如 : C:\Program Files\ 
Mozilla Firefox) ,并 输入 firefox. exe-ProfileManager -no-remote 命令 ,然后 按 Enter 键 , 调 
出 “Firefox - 选择 用 户 配置 文件 ”操作 窗口 .如 图 11-13 所 示 。 

(3) 在 弹出 的 FireFox 的 “选择 用 户 配置 文件 "对话 框 中 , 单 击 “ 创 建 配置 文件 ”按钮 ,在 
接 下 来 弹出 的 界面 中 直接 单 击 “下 一 步 ? 按 钮 ,显示 如 图 11-14 所 示 的 界面 。 

CD 在 弹出 的 “创建 配置 文件 向 导 ” 窗 体 中 的 “请 输入 新 的 配置 文件 名 称 : "对 应 的 输入 
框 中 输入 自 定义 的 配置 文件 名 称 ( 比 如 WebDriver) ,并 单 击 “ 完 成 ”按钮 完成 配置 文件 。 
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调 出 下 面 的 


Firefox 将 您 的 设置 、 首 选项 、 书 签 以 及 邮件 保存 在 您 的 个 人 配 
Exe. 


& default 
创建 配置 文件 (C) 


更 命名 配置 文件 (R)_ 
BUSES (D)... 


脱 机 工作 (O) 


司 动 时 不 询问 并 使 用 选 定 的 
配置 文件 (5S) 


| £a Firefox 退出 





图 11-13 


创建 配置 文件 向 导 





正在 完成 创建 配置 文件 向 导 


如 果 您 创建 多 个 配置 文件 ， 您 可 以 将 它们 命名 为 不 同 的 名 字 。 您 可 以 选择 使 用 这 里 
给 出 的 名 称 或 者 使 用 自己 指定 的 名 称 。 


请 输入 新 的 配置 文件 名 称 : 
| nume 


您 的 用 户 设置 ， 普选 项 以 及 其 他 相关 的 用 户 数据 将 被 保存 至 : 


CXUsersvSRAppDataWoamingWozillaVFirefoxVProfilesVidsktr52-BRt78. 
e 


CUR 





BERRO.. | 


单 击 “ 完 成 ”以 创建 新 的 配置 文件 。 





< 上 一 步 (B) | vk 取消 | 


图 11-14 








G) 在 “选择 用 户 配 置 文件 ”对 话 框 中 ,就 可 以 看 到 已 经 生成 的 用 户 自 定义 的 名 为 
WebDriver 的 用 户 配置 文件 ,选中 它 后 单 击 “ 启 动 Firefox” 按 钮 完成 自 定义 配置 文件 的 生 
成 ,如 图 11-15 所 示 。 


» 197 * 


P Selenium WebDriver 3.0 — & zh 4X e 2e 3c 4s 
e 








图 11-15 


(6) 启动 Firefox 浏览 器 后 ,在 设置 中 将 浏览 器 的 主页 设置 为 http://www. baidu. 
com, 也 就 是 让 浏览 器 学 习 一 遍 设置 主页 操作 , 记 住 这 个 过 程 。 
实例 代码 : 


# encoding - utf - 8 

from selenium import webdriver 

from selenium. common. exceptions import NoSuchElementException 
import unittest, time 


class TestCustomConf igurationBrowser(unittest. TestCase): 


def setUp(self): 
# OS fell H XE XCBO BE Se MF BRE GE EE 
proPath = "C: Users V SR AppData \ Roaming\ Mozilla Firefox| Profiles VV 6rfmnayB. 
WebDriver" 
* 加 裁 月 定义 配置 文件 到 FirefoxProfile Sz ffl ih, 
# 等 价 profile = webdriver. FirefoxProfile(proPath) 
profile = webdriver.firefox.firefox profile.FirefoxProfile(proPath) 
# 将 添加 本 新 配置 文件 的 Firefox W Wak Eb VUE IE T E 
profile. set_preference("browser. startup. homepage" , 
"http://www. sogou. con" ) 
# 设置 开始 页 面 不 是 空白 页 ,0 表示 空白 页 , 
# 这 一 步 必 须 做 , 否则 设置 的 主页 不 会 生效 
profile. set_preference(" browser. startup. page", 1) 
# 启动 带 有 自任 义 配置 文件 的 Firefox W Iia 
self.driver = webdriver.Firefox(executable path="c:\\geckodriver", 
firefox profile- profile) 


def testSoGouSearch( self): 
# FIF 5 EB, DUBIE RESA EIE 
time. sleep(5) 
try: 
# RIRH 3: VOIE efi AHEHE 
searchBox = self. driver. find element by id("query") 
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# ERIRE MAHE PRA "ERZ A hei" 
searchBox.send keys(u" 光荣 之 路 自动 化 测试 " ) 
# HIS d 
self.driver.find element by id("stb").click() 
time. sleep(10) 

except NoSuchElementException, e: 
print "修改 带 自 定义 配置 文件 的 浏览 器 主页 不 成 功 !" 


def tearDown(self): 
# 退出 Firefox ùW V gë 
self.driver.quit() 


if name  -- ' main ': 


unittest.main() 


代码 解释 : 

在 创建 Firefox 浏览 器 自 定义 配置 文件 时 ,已 经 将 浏览 器 的 主页 设 定 为 http://www. 
baidu. com, 而 在 带 着 此 自 定义 配置 文件 启动 浏览 器 前 ,又 通过 profile. set_ preference 
(" browser. startup. homepage" . "http://www. sogou. com" ) 语 句 , 将 浏览 器 此 时 的 主页 修 
改 为 搜狗 首页 ,所 以 在 启动 浏览 器 时 自动 打开 搜狗 主页 ,并 继续 后 续 的 搜索 操作 。 

更 多 说 明 : 

CD 通过 driver = webdriver. FirefoxCexecutable path "c: W geckodriver 3x FE fl 77 
式 启动 的 Firefox 浏览 器 均 是 一 个 不 带 任何 配置 ,不 带 任何 捅 件 等 信息 的 全 新 的 浏览 器 实 
例 ,通过 本 实例 的 介绍 ,读者 可 以 在 自动 化 实施 过 程 中 启动 自 定义 配置 信息 的 Firefox 实 
例 。 如 果 读 者 想 启 动 默认 的 Firefox 浏览 器 ,也 就 是 平时 我 们 手动 单 击 Firefox 快捷 启动 图 
标 启动 的 Firefox 浏览 器 ,可 以 将 本 例 中 的 自 定义 配置 信息 文件 换 成 默认 的 配置 文件 (扩展 
名 为 default 的 文件 夹 ,这 是 Firefox 默认 创建 好 的 ) ,其 存放 路 径 跟 用 户 自 定义 配置 文件 存 
放 在 同一 目录 下 。 

(2) 如 需 获 取 更 多 的 配置 项 ,请 读者 在 Firefox 浏览 器 地 址 栏 中 访问 about: config 进行 
查询 。 


目的 : 

能 够 使 用 配置 文件 存储 被 测试 页 面 上 页 面 元 素 的 定位 方式 和 定位 表达 式 , 做 到 定位 数 
据 和 程序 的 分 离 。 测 试 程序 写 好 以 后 ,可 以 方便 不 具备 编码 能 力 的 测试 人 员 进 行 自 定义 修 
改 配 置 。 此 部 分 内 容 可 以 作为 自 定义 的 高 级 自动 化 框架 的 组 成 部 分 。 

用 于 测试 的 网 址 : 


http://www. sogou. com 


实例 代码 : 
新 建 一 个 名 叫 SoGouTest 的 工程 ,工程 下 新 建 三 个 文件 ,分 别 为 SoGou. py、ObjectMap. py 
以 及 UiObjectMap. ini; 
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UiObjectMap. ini 页 面 元 素 定位 表达 式 配 置 文件 内 容 如 下 : 


[sogou] 
searchBox- id» query 
searchButton = id > stb 


ObjectMap. py 表示 ObjectMap 工具 类 文件 , 供 测试 程序 调用 ,内 容 如 下 : 


#encoding = utf - 8 

from selenium. webdriver. support. ui import WebDriverWait 
import ConfigParser 

import os 


class ObjectMap(object) : 
def init (self): 
* ONT BRI IE RE FE REIN Zr RE RES CI BO PI XC TT Pr fe TRIES 
# os.path.abspath( file );XdtHe ii x fF Ur TE MTE A R 
self.uiObjMapPath = os.path.dirname(os.path.abspath( file ))V 
+ "AMUiObjectMap. ini" 
print self.uiObjMapPath 


def getElementObject(self, driver, webSiteName, elementName): 
try: 
# 创建 一 个 恋 取 配置 文件 的 实例 
cf = ConfigParser. ConfigParser() 
# 将 配置 文件 内 容 加 裁 到 内 存 
cf. read(self.uiObjMapPath) 
# 根据 section 和 option EJ Ae Pi xc fF P Vili jo AE fr Zr 
# EISE CHI HEB, ET" Ahi 
locators = cf.get(webSiteName, elementName). split("5") 
# 得 到 定位 方式 
locatorMethod = locators[0] 
# 得 到 定位 表达 式 
locatorExpression = locators[1] 
print locatorMethod, locatorExpression 
Bodl x RI KIR I 
element - WebDriverWait(driver, 10). until(lambda x: V 
x.find element(locatorMethod, locatorExpression)) 
except Exception, e: 
raise e 
else: 
# OO IURE BETIS METER IBIDIURR EUR PLA LEE 


return element 


SoGou. py 中 调用 ObjectMap 工具 类 实现 测试 逻辑 ,该 文件 具体 内 容 如 下 : 


#encoding= utf - 8 

from selenium import webdriver 
import unittest 

import time, traceback 

from ObjectMap import ObjectMap 
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class TestSoGouByObjectMap(unittest. TestCase) : 


def setUp(self): 
self.obj = ObjectMap() 
# 启动 Firefox il d 25 


self.driver = webdriver.Firefox(executable path = "c: VV geckodriver" ) 


def testSoGouSearch( self): 

url = "http://www. sogou. com" 

# BH PE 

self.driver.get(url) 

try: 
# AID I IO di A fe 
searchBox = self.obj.getElenentObjectV 

(self.driver, "sogou", "searchBox") 
# EREM defi A FE rdi A "WebDriver SEA EH" 
searchBox. send keys(u"WebDriver 实战 宝典 ") 
Bo: 
searchButton = self.obj.getElementObjectV 
(self.driver, "sogou", "searchButton") 
# 单 击 茂 到 的 规 索 擅 细 
searchButton. click() 
# 等 竺 2 秘 , 以便 页 面 加 载 完 成 
time. sleep(2) 
# 肠 育 关键 字 " 吴 里 华 "是 否 按 预 期 出 现在 页 面 源 代码 中 
self. assertTrue(u" 吴 晓 华 ”in self. driver. page_source, 
"assert error!") 

except Exception, e: 

# TES A HEER EE 


print traceback. print exc() 


def tearDown(self): 
# 退出 Firefox WI 4r 
self.driver.quit() 


if nane  -- ' main ': 


unittest.main() 


更 多 说 明 : 

本 实例 实现 了 程序 与 数据 分 离 , 首 先 从 UI 对 象 库 文件 UiObjectMap. ini 文件 中 取得 
sogou 首页 中 需要 操作 的 页 面 元 素 的 定位 方式 和 定位 表达 式 ,然后 在 ObjectMap 类 中 取得 
该 页 面 元 素 的 实例 对 象 ,最 后 返回 给 测试 用 例 方法 中 进行 后 续 处 理 。 这 样 做 的 好 处 是 可 以 
在 一 定 条 件 下 满足 一 部 分 不 会 编码 的 测试 人 员 实 施 自 动 化 测试 。 














富 文 本 框 的 技术 实现 和 普通 的 文本 框 的 定位 存在 较 大 的 区 别 , 富 文本 框 的 常见 技术 
到 了 Frame 标签 ,并 且 在 Frame 里 面 实现 了 一 个 完整 的 HTML 网 页 结构 ,所 以 使 用 普通 的 
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定位 模式 将 无 法 直接 定位 到 富 文本 框 对 象 ,本 节 将 会 解决 这 个 问题 。 

目的 : 

能 够 定位 到 页 面 中 的 富 文本 框 对 象 并 进入 该 富 文本 框 ,然后 向 富 文本 框 中 输入 内 容 。 
使 用 JavaScript 代码 实现 向 富 文本 框 中 输入 HTML 格式 的 内 容 。 

用 于 测试 的 网 址 : 


http://mail.sohu. com 


实例 代码 1: 


#encoding= utf -8 

from selenium import webdriver 

import unittest, time, traceback 

from selenium. webdriver. support. ui import WebDriverWait 

from selenium. webdriver. support import expected conditions as EC 

from selenium. common. exceptions import TimeoutException, NoSuchElementException 
from selenium. webdriver. common. by import By 


class TestDemo(unittest.TestCase): 


def setUp(self): 
# 启动 Firefox W w 3 


self.driver = webdriver. Firefox(executable_path = "c:\\geckodriver" ) 


def test SohuMailSendEMail(self): 
url = "http://mail. sohu. com" 
# EHERCUE REOR C 
self.driver.get(url) 
try: 
userName = self.driver.find element by xpathV 
('//input[ ( placeholder = "请 输入 您 的 邮箱 " ] ') 
userName. clear() 
userName. send keys(" xxxx" ) 
passWord = self. driver. find element by xpath 
('//input[ (? placeholder = "请 输入 您 的 密码 " ] ') 
passWord. clear() 
passWord. send keys(" xxxx" ) 
login = self.driver.find element by xpath('//input[(2 value =" 登 录 " ]') 
login.click() 
wait = WebDriverWait(self.driver, 10) 
Ed CERE, MAE VCI JE ERDE RH BE PEE TAR D Je HD BF 
wait. until(EC.element to be clickableV 
((By.XPATH, '//li[text() =" 写 邮件 "]'))) 
self. driver. find element by xpath('//li[text() =" 写 邮件 "]').click() 
time. sleep(2) 
receiver = self. driver.find element by xpath\ 
('//div[ @arr -"mail.to render" ]//input') 
# MARHA 
receiver. send keys(" xxxx" ) 
subject = self.driver.find element by xpathV 
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('//input[ (2 ng - model = "mail.subject"]') 
# 输 人 邮件 标题 
subject. send_keys(u" 一 封 测试 邮件 !") 
# 获取 邮件 正文 编辑 区 域 的 iframe Wt JU RE 
iframe = self.driver.find element by xpath\ 
('//iframe[ contains((@id, "ueditor 0")]') 
* 通过 switch to. frane() Jr UJ f Vt A Ej XEHE P 
self. driver. switch to.frame(iframe) 
* XC XC fie PRN MIRI R 
editBox = self.driver.find element by xpath("/html/body") 
# 输 人 所作 正文 
editBox. send_keys(u" 邮 件 的 正文 内 容 " ) 
OM BOCK iE TEL ih, PZA D 
self.driver.switch to.default content() 
# ES EM X "Bel, JE Edom 
self.driver.find element by xpath('//span[. =" 43€" ]'). click() 
E BEGER A CREE IB" Rik CU" T IEZ HI PUT Uil P 
wait.until(EC.visibility of element locatedV 
((By.XPATH, '//span[. = "发 送 成 功 "]'))) 
print u" 邮件 发 送 成 功 ” 
except TimeoutException: 
print u" 显 式 等 待 页 面 元 素 超 时 ” 
except NoSuchElementException: 
print 寻找 的 页 面 元 素 不 存在 "，traceback. print_exc() 
except Exception: 
# TEC EE GEL 
print traceback. print exc() 


def tearDown(self): 


# 退出 Firefox W Wi ds 
self.driver.quit() 


if name  -- ' main ': 


unittest. main() 


实例 代码 2: 


#encoding= utf - 8 

from selenium import webdriver 

import unittest, time, traceback 

from selenium. webdriver. support. ui import WebDriverWait 

from selenium. webdriver. support import expected conditions as EC 

from selenium.common. exceptions import TimeoutException, NoSuchElementException 
from selenium. webdriver. common. by import By 


class TestDemo(unittest. TestCase): 
def setUp(self): 


# 启动 Firefox W i a 
self.driver = webdriver.Firefox(executable path="c:\\geckodriver") 
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def test SohuMailSendEMail(self): 
url = "http://mail. sohu. com" 
# BEN AES ER UU 
self.driver.get(url) 
try: 
userName = self. driver. find element by xpathV 
('//input[ (? placeholder = "请 输入 您 的 邮箱 " 1' ) 
userName. clear( ) 
userName. send keys(" xxxx" ) 
passWord = self.driver.find element by xpathV 
('//input[ (9 placeholder = "请 输入 您 的 密码 " ]' ) 
passWord. clear() 
passWord. send keys(" xxxx" ) 
login = self.driver.find element by xpath('//input[(2value -"Xé 3&"]') 
login. click() 
wait - WebDriverWait(self.driver, 10) 
* da CARE, Uli UII JE ERDE RH FE EY E RR T AY HER 
wait. until(EC. element_to_be_clickable\ 
( (By. XPATH, '//li[text() =" 5 8B f£" 1 ))) 
self.driver.find element by xpath('//li[text() = " 写 邮件 " ]').click() 
time. sleep(2) 
receiver = self.driver.find element by xpath\ 
('//div[(Zarr = "mail.to render" ]//input') 
# MAMEA 
receiver. send_keys("xxxx" ) 
subject = self. driver. find element by xpath\ 
('//input[ @ng - model = "mail.subject"]') 
# 给 人 计件 标题 
subject. send_keys(u" 一 封 测试 邮件 !") 
# 获取 邮件 正文 编辑 区 域 的 iframe 页面 无 素 对 条 
iframe = self.driver.find element by xpathN 
('//iframe[contains((v id, "ueditor 0")]') 
# 通过 switch to. frame( ) Jy i Ujta iE A. ap xc ok HEP 
self. driver. switch to. frame( iframe) 
# 通过 JavaScript {ÈP 1i] HE VEIE X 18 fie P fii A IE XC 
self. driver. execute_script(" document. getElementsByTagName( ' body ' )V 
[0]. innerHTML = '<b> 邮 件 的 正文 内 容 <b>;”) 
EOM XC fle UI ih, PEJZA RC IE 
self.driver.switch to.default content() 
# 找到 页 面 上 的 "发 送 "按钮 ,并 单 击 它 
self. driver. find element by xpath('//span[. = "发 送 "]'). click() 
# 星 式 等 符合 有 关键 字 毕 "发 送 成 功 " 的 页 面 元 豆 出 现在 页 面 中 
wait.until(EC.visibility of element located\ 
((By.XPATH, '//span[. = "发 送 成 功 "]'))) 
print u" 邮 件 发 送 成 功 ” 
except TimeoutException: 

print u" 显 式 等 待 页 面 元 素 超 时 "” 
except NoSuchElementException: 

print u" 寻 找 的 页 面 元 素 不 存在 ", traceback. print_exc() 
except Exception: 


# 打印 其 他 蜡 常 堆栈 信息 
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print traceback. print exc() 


def tearDown(self): 
* 退出 Firefox DI Wi d 
self.driver.quit() 


if name == ' main ': 





unittest. main( ) 


实例 代码 3: 


#encoding= utf -8 
from selenium import webdriver 
import unittest, time, traceback 
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from selenium. webdriver. support. ui import WebDriverWait 


from selenium. webdriver. support import expected conditions as EC 

from selenium. common. exceptions import TimeoutException, NoSuchElementException 
from selenium. webdriver. common. by import By 
from selenium. webdriver. common. keys import Keys 


import win32clipboard as w 
import win32api, win32con 


# MIF EREDI Nht E 

def setText(aString): 
w. OpenClipboard() 
w. EnptyClipboard() 


w. SetClipboardData(win32con.CF UNICODETEXT, aString) 


w. CloseClipboard() 


# bHATERI AI EM 
VK CODE = ('ctrl':0xll, 'v':0x56) 


EORRETET 
def keyDown(keyNane) : 


win32api.keybd event(VK CODE[keyName], 0, 0, 0) 


# Ade 
def keyUp(keyName) : 


win32api.keybd event(VK CODE[keyName], 0, win32con. KEYEVENTF KEYUP, 0) 


class TestDemo(unittest. TestCase): 


def setUp(self): 
Z xj Firefox | Hg 


self.driver = webdriver.Firefox(executable path- "c: geckodriver" ) 


def test SohuMailSendEMail(self): 
url = "http://mail. sohu. com" 
zig e fS ER uU 
self.driver.get(url) 
try: 


userName = self.driver.find element by xpathV 
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('//input[ (2 placeholder = "请 输入 您 的 邮箱 " 1' ) 
userName. clear() 
userName. send keys(" xxxx" ) 
passWord = self.driver.find element by xpathV 
('//input[ (à placeholder = "请 输入 您 的 密码 " ]' ) 
passWord. clear() 
passWord. send keys(" xxxx" ) 
login = self.driver.find element by xpath('//input[(Zvalue -"X* 3g"]') 
login.click() 
wait - WebDriverWait(self.driver, 10) 
EOS CARERE, I XE VEI JE S III ERO BFE YE MCI I D EE RC 
wait. until(EC.element to be clickableV 
( (By. XPATH, '//li[text() - "S 8p 4E" ]'))) 
self.driver.find element by xpath('//li[text() =" 5 BB 4E" ] ').click() 
tine. sleep(2) 
receiver = self.driver.find element by xpathV 
('//div[(Garr = "mail.to render" ]//input') 
# MAMEA 
receiver. send keys(" xxxx" ) 
subject = self.driver.find element by xpathN 
('//input[ @ng - model = "mail.subject"]') 
# A BIERRA 
subject. send_keys(u" 一 封 测试 邮件 !") 
A PRA SEHETE ERE ET, EEF Tab fi nT LA FG TE IT FIG UI Ha FY p XC fé A HEIC 
subject. send keys(Keys. TAB) 


E BERDI Wi BIN SR, UL RERE A TEE CIN E 


setText(u" 邮件 正文 内 容 ") 
# BUD REGE Ctrl + V IH ERE, TEE RE BELA A I E CIS AIC 
keyDown(" ctr1") 


keyDown(" v" ) 
keyUp(" v" ) 
keyUp(" ctrl") 
# RITHE" X "Tf, JE dom 
self.driver.find element by xpath('//span[. = "发 送 " ]'). click() 
EU AERA A HE BI EDI" T IIZ HI UT CIE 
wait.until(EC.visibility of element locatedV 
((By.XPATH, '//span[. = " E 3X EJ" 1 ))) 
print u" 邮 件 发 送 成 功 " 
except TineoutException: 
print v' 显 式 等 待 页 面 元 素 超 时 " 
except NoSuchElementException: 
print uw" 寻 找 的 页 面 元 素 不 存在 ",， traceback.print exc() 
except Exception: 
# HREH KHE E 
print traceback. print exc() 


def tearDown(self): 
# 退出 Firefox Ù Ii ds 
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self. driver. quit() 


if name == ' main ': 


unittest.main() 


在 以 上 三 个 实例 代码 中 ,读者 需要 将 代码 中 以 “xxxx" 字 符 串 代替 的 搜狐 邮 
箱 用 户 名 、 密 码 以 及 收 件 人 地 址 替换 成 有 效 的 数据 ,否则 程序 会 报错 。 








如 果 遇 到 登录 邮箱 时 需要 手机 号 验证 ,或 者 需要 输入 验证 码 ,请 读者 手动 完成 。 

更 多 说 明 

以 上 三 种 方法 都 能 实现 向 搜狐 邮箱 写 信和 页面 的 富 文本 框 中 输入 内 容 , 但 它们 之 间 又 有 
什么 区 别 呢 ? 三 种 方法 的 比较 如 下 。 

方法 1: 

优点 : 实现 简单 ,只 要 调用 WebDriver 对 页 面 元 素 对 象 提 供 的 send_keys() 方 法 , 即 可 
实现 内 容 输入 。 

缺点 : 必须 能 定位 到 要 被 操作 元 素 , 对 脚本 编写 人 员 的 定位 能 力 要 求 比较 高 ,同时 不 支 
持 HTML 格式 的 内 容 输入 。 





i: 可 以 支持 HTML 格式 的 文字 内 容 作为 富 文本 框 的 输入 内 容 。 

缺点 : 由 于 各 种 网 页 中 富 文本 框 实现 的 机 制 可 能 不 同 , 有 可 能 造成 定位 到 富 文本 框 的 
文本 编辑 区 对 象 比 较 困 难 ,此 时 就 需要 熟练 了 解 HMTL 代码 含义 以 及 Frame 的 进出 方式 ， 
对 脚本 编写 人 员 的 能 力 要 求 就 比较 高 。 

方法 3: 

优点 : 不 管 何 种 类 型 的 富 文本 框 ,只 要 找到 它 上 面 的 紧邻 元 素 , 然 后 通过 模拟 按 Tab 键 
的 方式 均 可 进入 到 富 文本 框 中 ,由 此 可 以 使 用 一 种 方法 解决 所 有 类 型 的 富 文本 框 定位 问题 。 

缺点 : 不 能 在 富 文本 框 编辑 器 中 进行 HTML 格式 的 内 容 输入 。 

以 上 三 种 方式 各 有 利弊 ,只 要 能 够 相对 稳定 地 完成 对 富 文本 框 的 操作 ,读者 可 以 自行 选 
择 任意 一 种 方法 使 用 。 


11.13 M zr pausa: pua 





目的 : 

在 测试 过 程 中 ,一 般 会 对 核心 页 面 进行 截图 ,并 且 使 用 测试 过 程 中 所 截图 和 以 前 测试 过 
程 中 的 截图 进行 精确 的 比 对 。 如 果 精 确 百分之百 匹配 ,可 以 判断 两 张 图 片 完 全 一 致 ,如 果 页 
面 中 发 生 了 任何 微小 的 变化 ,都 会 认为 图 片 不 匹配 。 

环境 准备 : 

(D) Windows Ff WIN 十 R 组 合 键 . 调 出 运行 窗口 ,在 “打开 ”输入 框 中 输入 *CMD” 后 
回 车 , 调 出 CMD 窗口 ,然后 在 CMD 窗口 执行 “pip install pillow ”安装 Python 图 像 处 理 库 ， 
安装 成 功 界面 如 图 11-16 所 示 。 

(2) CMD 下 进入 Python 交互 模式 ,执行 from PIL import Image 命令 ,如果 没有 报错 ， 
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X vendor reque: 
ngWarning: An HTT e ,but the SNI (Subject Name Indication) 
s not available on this platform. This may cause the server to present an incorrect TLS] 
which can cause validation failures. You can upgrade to a newer version of Python to 
,For wore information, see http: urllib3. readthe: org/en/latest/security. btml#snimi 


ingWarning 
IX ibVsite-packages Wpip-8. 1. 2-py2. 7. eggN P \reques \urllib3\util\ p 
: InsecurePlatformWarning: A true SSLContext object is not available. is prevents urllib3 from 


uring SSL appropriately and may cause certain SSL connections to fail. You can upgrade to a 
ewer version of Python to solve thi or more information, see https://urllib3. readthedocs. org/en/1 
htest/security. htaliinsecureplatformwarning 

InsecurePlatformWarning 
wnloading Pillow-4.0.0-cp27-cp27m-win32.whl (1. 2MB) 
OO MENEEBEEENEENEENEEEEEEREENEEENEEEENHENHENH è Œ 
ollecting olefile (from pillow) 
Downloading olefile-0.44.zip (74kB) 
1000 MENEEEEEEEEHENHEEEEEEBEEEENHENEBEENEEH 0:70 
ling collected packages: olefile, pillo 
i setup. py install for 
x 44 pillow "iUm S 





图 11-16 


说 明 Python 图 像 处 理 库 Pillow 已 经 安装 成 功 

如 果 直 接 使 用 pip 工具 不 能 成 功 安装 Pillow 库 , 请 访问 https://pypi. python. org 
pypi/Pillow/4.0.0, 根 据 安装 的 Python 版 本 及 位 数 选择 相应 的 离线 安装 文件 进行 安装 , 注 
意 下 载 的 Pillow 离线 安装 文件 版 本 及 位 数 必须 与 已 安装 的 Python 版 本 及 位 数 保持 一 致 ， 
否则 会 安装 失败 

用 于 测试 的 网 址 : 











http://www. sogou. com 
实例 代码 : 


#encoding= utf -8 
from selenium import webdriver 
import unittest, time 

from PIL import Image 


class InageConpare( object) : 
本 类 实现 本 对 两 张 图 片 通过 像 本 比 对 的 算法 ,获取 文件 的 像素 个 数 大 小 


然后 合用 循环 的 方式 将 两 张 图 片 的 所 有 项 目 进 行 一 一 对 比 , 
黑 的 相似 度 的 百分比 








def make regalur image(self, img, size = (256, 256)): 
5E EDT ROFPREBIE ROUESIER size 大 小 
* 然后 再 将 其 转换 成 RGB [f 
return img.resize(size).convert('RGB') 





def split image(self, img, part size = (64, 64)): 
ESEE HHEAEKANUI 


w, h = img.size 
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pw, ph = part size 
assertw % pw == h % ph == 0 
return [img.crop( (i, j, i + pw, j + ph)).copy() V 
for i in xrange(0, w, pw) for j in xrange(0, h, ph)] 


def hist_similar(self, lh, rh): 
# HIM ERA ELA KAA BE USE R 
assert len(1h) == len(rh) 
return sum(1 - (0 if 1 == r elsefloat(abs(l - r)) / max(1l, r)) V 
for l, r in zip(1h, rh)) / len(1h) 


def calc similar(self, li, ri): 
# 计算 两 张 图 片 的 相似 度 
return sum(self.hist similar(l.histogram(), r.histogram())N 
forl, rinzip(self.split image(li), self.split image(ri))) / 16.0 


def calc similar by path(self, lf, rf): 
li, ri = self.make regalur image(Image. open(1lf)), V 
self.make regalur image(Image. open(rf)) 
return self.calc sinilar(li, ri) 


class TestDemo(unittest. TestCase): 


def setUp(self): 
self. IC = InmageCompare() 
# 启动 Firefox W V as 
self.driver = webdriver.Firefox(executable path = "c: VW geckodriver" ) 


def test ImageComparison(self): 
url = "http://www. sogou. com" 
# 访问 搜狗 首页 
self.driver.get(url) 
time. sleep(3) 
# 截取 第 一 次 访问 搜狗 首页 的 图 片 ,并 保存 在 本 地 
self. driver. save_screenshot("D:\\book\\sogoul. png" ) 
self.driver.get(url) 
time. sleep(3) 
# 戴 用 第 二 次 访问 搜狗 首页 的 图 片 ,并 保存 在 本 地 
self. driver. save_screenshot("D:\\book\\sogou2. png" ) 
# 采 印 两 张 截图 比 对 后 的 相似 度 , 100 表示 完全 匹配 
print self.IC.calc similar by path('D:WbookM sogoul. png', V 
'D: \\book\\sogou2. png') * 100 


def tearDown(self): 
# 退出 Firefox Wl W is 
self; driver. quit() 


if name  -- ' main 


unittest.main() 
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11.14 示 正 在 操作 的 页 





目的 : 
在 测试 过 程 中 ,经 常会 进行 调试 工作 ,使 用 高 亮 显 


示 被 操作 页 面 元 素 的 方式 可 以 提高 调 
试 过 程 中 的 效率 ,以 显眼 的 颜色 高 亮 显示 的 方式 提示 测试 人 员 目 前 正在 操作 的 页 面 元 素 。 
用 于 测试 的 网 址 : 





http://www. sogou. com 


实例 代码 : 


# encoding = utf - 8 
import unittest 
from selenium import webdriver 


import time 


def highLightElement (driver, element) : 
# PIRIT H PIREA DIZ I Zr i 
# MEM JavaScript (CPI f£ A I I H ICRI R BU TT FERN E A HE BN RE E 
# 绿色 和 红色 
driver.execute script("arguments[0]. setAttribute('style',V 
arguments[1]);", element,"background:green; border:2px solid red;") 


class TestDemo(unittest. TestCase): 
def setUp(self): 
# DEH E SEED SE n] 


self.driver = webdriver.Firefox(executable path = "c: Wgeckodriver") 


def test HighLightWebElement(self): 
url = "http://sogou. com" 
# 访问 搜狗 首页 
self.driver.get(url) 
searchBox - self.driver.find element by id("query") 
# WERE ds JOE MHK PRÉC, TET EAR A ME DETTA US 
highLightElement(self.driver, searchBox) 
# PIF 3 E, UD (BEES AZAR 
time. sleep(3) 
searchBox. send_keys(u" 光 荣 之 路 自动 化 测试 " ) 
submitButton = self.driver.find element by id("stb") 
# OBI AS Sls JOE ME K PR EC, EIE ET MAET IEEE o 
highLightElement(self.driver, submitButton) 
time. sleep(3) 
subnitButton.click() 
time. sleep(3) 





def tearDown(self): 
# iB ii UI SE 
self. driver. quit() 


~ A0- 
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if name  -- ' main ': 


unittest.main() 





目的 : 

在 同一 浏览 器 中 新 开 一 个 或 多 个 新 的 标签 页 ,同时 能 在 这 些 标签 页 中 输入 测试 网 址 进 
行 测 试 。 

用 于 测试 的 网 址 : 


http://www. sogou. com 
http://www. baidu. com 


实例 代码 : 


# encoding - utf - 8 

import unittest 

from selenium import webdriver 
import time 

import win32api, win32con 


VK CODE = ('ctrl':Ox11l, 't':0x54, 'tab':0x09] 


# ARIEF 
def keyDown(keyNane) : 
win32api.keybd event(VK CODE[keyName], 0, 0, 0) 
# Ade 
def keyUp(keyName) : 
win32api.keybd event(VK CODE[keyName], 0, win32con. KEYEVENTF KEYUP, 0) 


# HACER E 
def simulateKey(firstKey, secondKey): 
keyDown( firstKey) 
keyDown( secondKey) 
keyUp( secondKey) 
keyUp(firstKey) 


class TestDeno(unittest. TestCase) : 
def setUp(self): 
A DEIRI HE AE EE 
self.driver = webdriver.Firefox(executable path = "c:\\geckodriver" ) 


def test newlab(self): 
E EIF 3 Eb, EIF DU ML e BIER 
time. sleep(3) 
* 使 用 for 循环 ,再 新 开 两 个 新 的 标签 页 
for i in range(2): 
simulateKey("ctrl", "t") 
# 通过 Ctrl + Tab A6 f, 45 BÍ CIL UT PR DJ POI WEIL, 
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# 也 就 是 最 先 打 开 的 标签 页 

simulateKey("ctrl", "tab") 

# 访问 搜狗 首页 

self.driver.get(" http: //sogou. con" ) 

self.driver.find element by id("query"). send keys(u 光荣 之 路 " ) 
self.driver.find element by id("stb").click() 

tine. sleep(3) 

self.assertTrue(u" 乔 什 ' 卢 卡 斯 " in self.driver.page source) 


# KAITI K A O 

all handles = self.driver.window handles 

print len(all handles) 

# 将 当前 窗口 句柄 切 揪 至 第 二 个 奈 签 页 

self.driver. switch to.window(all handles[1]) 

self.driver.get("http: //www. baidu. con" ) 

self.driver.find element by id("kw").send keys(u"WebDriver 实战 宝典 " ) 
self.driver.find element by id("su").click() 

tine.sleep(3) 

self.assertTrue(u" E B&fE" in self.driver.page source) 


self. driver. switch to.window(all handles[2]) 
self.driver.get("http: //www. baidu. con" ) 

self.driver.find element by id("kw").send keys("selenium") 
self.driver.find element by id("su").click() 

time. sleep(3) 

self.assertTrue("www.seleniumhq.org" in self.driver.page source) 


def tearDown(self): 
zB NES 
self.driver.quit() 


if name == ' 


unittest. main() 


说 明 : 
IE 浏览 器 对 本 节 实 例 不 支持 。 


11.16 Eito ie 43 2 言 失败 时 进行 屏幕 截 





目的 : 

在 自动 化 测试 执行 过 程 中 .有 可 能 会 抛 异 常 或 断言 失败 的 情况 ,此 时 通过 对 发 生 异 常 或 
断言 失败 的 页 面 截图 操作 ,可 以 方便 自动 化 测试 人 员 进 行 BUG 定位 及 问题 排查 。 

用 于 测试 的 网 址 : 


http://www. sogou. com 


实例 代码 : 
首先 在 PyCharm 工具 中 新 创建 一 个 名 为 GloryRoad 的 Python 工程 ,然后 在 该 工程 下 
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面 创建 DateUtil. py, FileUtil. py 以 及 SoGou. py 这 三 个 Python 文件 。 
DateUtil. py 文件 具体 内 容 如 下 : 
# encoding = utf - 8 


import time 
from datetime import datetime 





本 文件 主要 用 于 获取 当前 的 日 期 以 及 时 间 ， 
用 于 生成 保存 截图 文件 目录 名 


def currentDate(): 
date = time. localtime() 
# Hk X HIIS IT 
today = str(date.tm year) + "-" + str(date.tm mon) + "-" + str(date.tm mday) 
return today 


def currentTine() : 
timeStr = datetime.now() 
# Bu iiH FAF R 
now = timeStr.strftime(' $H- %M- %S') 
return now 
if _name == " main ": 
print currentDate() 
print currentTime( ) 


FileUtil. py 文件 的 具体 内 容 如 下 : 


# encoding - utf - 8 
from DateUtil import currentDate, currentTime 
import os 


本 文件 主要 用 于 创建 目录 ,用 于 存放 异常 截图 ， 
创建 目录 的 方法 仅 供 大 家 参考 , 将 来 用 于 根据 测试 
需要 创建 测试 人 员 需 要 的 目录 或 文件 等 


def createDir(): 
# DEOR "EL XC TEE TE H F Hg B ERE GE 
currentPath - os.path.dirname(os.path.abspath( file )) 
# XOU XM H HIE HEB 
today = currentDate() 
# HEUS X Hia HU ELEGIR XERIETE 
dateDir = os.path. join(currentPath, today) 
print dateDir 
if not os. path. exists(dateDir): 
# 如 打 以 今天 日 期 命名 的 有 目录 不 存在 则 创建 
os. mkdir(dateDir) 
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# 获得 当前 的 时间 字符 此 

now = currentTime() 

# 攀 效 以 当前 时 间 俞 名 的 月 录 的 缩 对 路 径 

timeDir = os.path. join(dateDir, now) 

print timeDir 

if not os. path. exists(timeDir): 
# UA A PERSE IRI n d h9 A SR AI T TENY 0] 
os. mkdir(timeDir) 

return timeDir 


FileUtil. py 文件 的 具体 内 容 如 下 : 


# encoding = utf - 8 

from selenium import webdriver 
import unittest, time, os 

from FileUtil import createDir 
import traceback 


* 创建 存放 蜡 常 截图 的 月 录 , HR SE BID FECI A M BOE REGE, 
# 并 且 作 为 全 局 变量 ,以 供 杰 次 所 有 测试 用 例 调用 


picDir = createDir() 


def takeScreenshot (driver, savePath, picName): 
# HRIBE iK 
# HnEBRERISBEE RIS 4 
* 因为 Windows 默认 编码 是 GBK, 而 传人 的 图 片 名 为 utf8 ARS, 
# 所 以 这 里 需要 进行 转 码 , 以便 让 图 片 名 中 的 中 文字 符 能 正常 显示 
picPath = os.path. join(savePath, str(picName).decode("utf - 8").encode("gbk")\ 
* ".png") 
try: 
# 调用 WebDriver 提供 的 get screenshot as_file() 方 法 ， 
# HEAR I hY DERE ETH RIESI E H XMF 
driver.get screenshot as file(picPath) 
except Exception, e: 
# TIS WOEHITB 
print traceback. print exc() 


class TestFailCaptureScreen(unittest. TestCase) : 


def setUp(self): 
# 启动 Firefox W W 2 
self.driver = webdriver.Firefox(executable path- "c: geckodriver" ) 


def testSoGouSearch( self): 
url = "http://www. sogou. com" 
# 访问 搜狗 首页 
self.driver.get(url) 
try: 
self.driver.find element by id("query").V 
send keys(u" 光荣 之 路 自动 化 测试 ") 
self. driver. find element by id("stb").click() 
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time. sleep(3) 

# OH RUM PERAE" FREAK" d 4 PREF, 

# 因为 页 面 由 没有 这 4 个 字 , 所 以 会 触发 except VERIBIIATT, H Ah 2 IER TE 

self. assertTrue(u" 事 在 人 为 " in self.driver.page source, V 

"" 事 在 人 为 "关键 字 串 在 页 面 源 代码 中 未 找到 ") 

except AssertionError, e: 

# 调用 封装 好 的 截图 方法 ,进行 截图 并 保存 在 未 地 磁盘 

takeScreenshot(self.driver, picDir, e) 
except Exception, e: 

print traceback. print exc() 

takeScreenshot(self.driver, picDir, e) 


def tearDown(self): 


# iH Firefox ul a 
self.driver.quit() 


if name  -- ' main ': 
unittest. main( ) 
更 多 说 明 : 
此 实例 借助 了 两 个 工具 文件 DateUtil. py 和 FileUtil. py 来 实现 本 次 测试 的 目的 ,当然 
读者 也 可 以 将 这 两 个 文件 中 的 方法 封装 到 类 中 形成 工具 类 ,此 种 方法 将 常用 的 代码 进行 封 
装 ,便于 提高 代码 的 复 用 度 ,提高 测试 脚本 编写 的 效率 。 


11.17 MES Yb 





目的 : 

在 自动 化 测试 脚本 的 执行 过 程 中 ,使 用 Python 的 日 志 模 块 (logging) 记 录 在 测试 用 例 
执行 过 程 中 一 些 重要 信息 或 者 错误 日 志 等 ,用 于 监控 和 后 续 调 试 脚本 。 

用 于 测试 网 址 : 


http://www. sogou. com 


实例 代码 : 

在 PyCharm 工具 中 新 建 一 个 名 叫 SoGouSearch 的 Python 工程 ,并 在 工程 下 创建 
Log. py, Logger. conf 以 及 SoGou. py 三 个 文件 。 

Logger. conf 文件 具体 内 容 如 下 : 

BEBERRBEHEBEBEREHERERREREREREEER ——— 

BBBESEEEEEE propagate 是 否 继承 父 类 的 log 信息 ,0: 否 


[1oggers] 
keys = root, exanple01, exanple02 





[1ogger root] 

level = DEBUG 

handlers - hand01, hand02 
[1ogger example01] 
handlers - hand01, hand02 
qualname - example01 


-25> 
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propagate - 0 


logger example02] 

handlers - hand01, hand03 

qualname - example02 

propagate - 0 

PPPRHPHHP PRHE HEP HHEH Ep Ep pp pyu puppy pppn 
handlers] 

keys = hand01 , hand02, hand03 

handler_hand01 
class = StreamHandler 
level = DEBUG 
formatter = form01 
args = (sys. stderr, ) 
handler_hand02 
class = FileHandler 
level = DEBUG 
formatter = form01 
args = ('d:\\AutoTestLog. log', 'a') 
handler_hand03 
class = handlers. RotatingFileHandler 

level = INFO 

formatter = form01 

args = ( 'd:\\AutoTestLog. log', 'a', 10 x 1024 » 1024, 5) 

HPHP HRR REPR PER RPPP PPH EHPHRHHHR HHE E E pp pHRRHHH 
[formatters] 











keys = form01, form02 

[formatter form01] 

format = % (asctime)s *(filename)s[line: % (lineno)d] $(levelname)s % (message)s 
datefmt = $Y- $m- $d $H: M: $S 

[formatter form02] 

format = % (name) - 12s: % (levelname) -8s % (message)s 

datefmt = $Y- $m- $d $H: $M: $S 


Log. py 文件 具体 内 容 如 下 : 


# encoding = utf - 8 
import logging.config 


logging. config. fileConfig("Logger. conf" ) 


def debug(message) : 
# 打印 debug 级 别 的 日 志方 法 
logging. debug( message) 


def warning(message) : 
# 打印 warning 级 别 的 日 志方 法 
logging. warning(message) 


def info(message): 


# 打印 info ZEB H d Zik 
logging. info(message) 
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dü 


SoGou. py 文件 具体 内 容 如 下 : 


# encoding = utf - 8 

from selenium import webdriver 

import unittest 

# 从 当前 文件 万 在 月 灵 中 时 人 Log. py X fih BE NE 
from Log import * 


class TestSoGouSearch(unittest. TestCase) : 
def setUp(self): 
# JAZ) Firefox W) Wi 25 


self.driver = webdriver.Firefox(executable path = "c: WW geckodriver" ) 


def testSoGouSearch( self): 





url = "http://www. sogou. com" 

# 访问 搜狗 首页 

self.driver.get(url) 

info(u" 访 问 sogou 首页 ") 

self.driver.find element by id("query"). send_keys(w" 光 荣 之 路 自动 化 测试 ") 
info(u" 在 输入 框 中 输入 搜索 关键 字 串 "光荣 之 路 自动 化 测试 "") 

self. driver. find element by id("stb").click() 

info(u" 单 击 搜索 按钮 ") 

info(u" ========== 测试 用 例 执行 结束 ==========") 


def tearDown(self): 
# 退出 Firefox W w a 
self.driver.quit() 


if name  -- ' main ': 
unittest. main() 


执行 结果 : 
执行 SoGou. py 文件 后 ,会 在 本 地 磁盘 D 盘 中 生成 一 个 日 志文 件 AutoTestLog. log, H 


志文 件 中 的 内 容 如 下 : 


2016-11-28 16:15:52 SoGou. py[line:15] INFO ============== 搜索 ============== 
2016-11-28 16:15:57 SoGou. py[1ine:19] INFO 访问 sogou 首页 

2016 - 11- 28 16:15:58 SoGou. pyl line:21] INFO 在 输入 框 中 输入 搜索 关键 字 串 "光荣 之 路 自动 化 测试 " 
2016-11- 28 16:15:58 SoGou. py[1ine:23] INFO 单 击 搜索 按钮 

2016 - 11 - 28 16:15:58 SoGou. py[ line:24] INFO ========== 测试 用 例 执行 结束 ========== 


由 此 可 实现 在 测试 过 程 中 打印 日 志 的 目的 ,并 用 于 后 期 分 析 哪 些 测试 语句 被 正确 执行 


了 ,以 及 哪些 测试 语句 执行 失败 了 。 


更 多 说 明 : 
本 实例 中 日 志 的 级 别 只 配置 到 DEBUG 级 别 ,如 果 读 者 有 需要 打印 其 他 级 别 的 日 志 , 请 


自行 修改 Logger. conf 文件 中 的 相关 内 容 。 上 述 针对 打印 日 志 的 配置 可 以 满足 日 常 测试 需 
要 ,如 果 对 上 面 日 志 配置 信息 有 不 明白 或 需要 更 多 自 定 义 的 日 志 需 求 , 请 访问 https:// 
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docs. python. org/2/howto/logging. html 进一步 学 去 





11.18 FEEF- ICE 3 TREES 

目的 : 

能 够 使 用 自己 编写 操作 表格 的 公用 类 ,并 基于 公用 类 进行 表格 中 元 素 的 各 类 操作 。 
用 于 测试 网 页 的 HTML 代码 : 

<html> 

<head> 


<title > 设置 文本 框 属性 </title > 
<meta http - equiv = "Content - Type" content = "text/html; charset = utf — 8" /> 











</head> 
X body» 
«table width = "400" border = id = "table" 
«tr» 
«td align="left"> 
<p> 第 一 行 第 一 列 </p> 
< input type = "text"></input > 
</td> 


<td align = "left"> 
<p> 第 一 行 第 二 列 </p> 


text"></input > 






< input type = 
</td> 
<td align = "left"> 
<p> 第 一 行 第 三 列 </p> 
< input type = "text"></input > 
</td> 
</tr> 
<tr> 
<td align="left"> 
<p> 第 二 行 第 一 列 </p> 
< input type = "text"></input > 








</td> 
<td align = "left"> 
<p> 第 二 Ae p» 
< input type = "text"></input > 
</td> 
<td align = "left"> 
<p> 第 二 行 第 三 列 </p> 
< input type = "text"></input > 
</td> 
</tr> 
<tr> 


<td align="left"> 

<p> 第 三 行 第 一 列 </p> 

< input type = "text"></input > 
</td> 
<tdalign= "left"> 
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<p> 第 三 行 第 二 列 </p> 
< input type = "text"></input > 
</td> 
<td align="left"> 
<p> 第 三 行 第 三 列 </p> 
< input type = "text"></input > 
</td> 
</tr> 
</table> 
</body> 
</html > 


实例 代码 : 
Table. py 文件 具体 内 容 如 下 : 


#encoding= utf -8 


class Table(object): 
# EX—4R 8 ft table, 用 于 存放 table XI 
. table = '' 


def init (self, table): 
# Table 类 的 构造 方法 
self.setTable(table) 


def setTable(self, table): 
# XIRAN tE table HEIT R fri tR ME 
self. table = table 


def getTable(self): 
£OJOIUÉ WIE table Hfi 


return self. table 


def getRowCount(self): 
# iE [n] table 对 象 中 所 有 的 行 tr Est UR XE 


return len(self._ table.find elements by tag name("tr")) 


def getColumnCount(self): 
# NICE NES II PLE 


return len(self. table.find elements by tag name("tr")[0].V 
find elements by tag name("td")) 


def getCell(self, rowNo, colNo): 

# KRK PRIRA OC NEXESR 

try: 
# RIKE PHR M f, AKTGA 0 开始 , 
# MMERB=IT, MERIT 3 - 1 = 2 来 获取 第 三 行 tr 元素 对 象 
currentRow = self. table.find elements by tag name("tr")[rowNo - 1] 
# TBI fT3ERI E, ARRIT PRA, AGEMA 0 开始 
currentCol - currentRow.find elements by tag name("td")[colNo - 1] 
# PRIMATI A 
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return currentCol 
except Exception, e: 


raise e 


def getWebElementInCell(self, rowNo, colNo, by, value): 

# NOCET FT AUI OC PRENAR, 

# by GR AE MU HICK BO Jr A, 比如 id, 

# value 表示 定位 表达 式 , 比如 query 

try: 
currentRow = self. table.find elements by tag name("tr")[rowNo - 1] 
currentCol - currentRow.find elements by tag name("td")[colNo - 1] 
# GOIGREAM T YOOMEIP ACT OBERE 
element - currentCol.find element(by - by, value - value) 
# BIRF M CR XE 
return element 

except Exception, e: 
raise e 


OperTable. py 文件 具体 内 容 如 下 : 


#encoding= utf - 8 

from selenium import webdriver 

import unittest 

import time 

* MU xc ITE TE H 3 FFA Table. py 文件 中 的 Table 2€ 
from Table import Table 


class TestTableOpertion(unittest. TestCase): 


def setUp(self): 
# 启动 Firefox NW as 
self.driver = webdriver.Firefox(executable path = "c: WV geckodriver" ) 


def testTable(self): 
url = "D:WbookV html. html" 
# 访问 自 定义 的 网 页 
self.driver.get(url) 
# HEH t M BUR I DB E MEO, JE Ei E webTable 变量 中 
webTable = self.driver.find element by tag name("table") 
# fEJI] webTable 变量 对 Table 类 进行 实例 化 
table = Table(webTable) 
# Ami MIT 
print table. getRowCount( ) 
# 统计 表格 的 列 数 
print table. getColumnCount( ) 
# KREM PR LIB oC 
cell - table.getCell(2, 3) 
# OBDEAEJRUM ÉD CEA REEE" BITRA" 
self.assertAlmostEqual(u" $ 247 $ 2 JJ", cell. text) 
# KREK PRTB AAH PAER R 
cellInput = table.getWebElementInCell(3, 2, "tag name", "input" ) 
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# 在 找到 的 输 人 旋 中 输 人 "第 三 行 的 第 二 列表 棒 设 找到 "关键 字 内 和 众 
cellInput. send_keys(u" 第 三 行 的 第 二 列表 格 被 找到 ") 

# FR 3 B, 内 腿 查 看 输 人 效果 

time. sleep(3) 





def tearDown(self): 
# iBih Firefox Ñ) W g 
self. driver. quit() 


if name == ' main ': 


unittest. main( ) 


执行 OperTable. py 文件 ,可 以 看 到 操作 表格 的 公用 类 在 测试 过 程 中 被 成 功 调用 。 


OperTable. py 文件 和 Table. py 文件 在 同一 级 目录 中 。 





LE 局 测试 HTML5 语言 实现 的 视频 播放 器 





目的 : 

能 够 获取 HTML5 语言 实现 的 视频 播放 器 视频 文件 的 地 址 .时 长 ,控制 播放 器 进行 播 
放 或 暂停 播放 等 操作 。 

用 于 测试 的 网 址 : 


http://www. w3school. con. cn/tiy/loadtext.asp?f = html5 video simple 


实例 代码 : 


#encoding= utf -8 
import unittest 
from selenium import webdriver 


import time 


class TestDeno(unittest. TestCase) : 
def setUp(self): 
# ENG V E SI fa 


self.driver = webdriver.Firefox(executable path = "c: Wgeckodriver") 


def test HIML5VideoPlayer(self): 
url - "http://www.w3school.com.cn/tiy/loadtext.asp?f - html5 video simple" 
# 访问 HIML5 语音 实现 的 播放 天 网 页 
self.driver.get(url) 
# 打印 访问 网 页 的 页 面 源 代 码 , 供 读者 学 习 
print self. driver. page_source 
# 获取 页 面 中 的 video f E JU EXE 
videoPlayer = self.driver.find element by tag name(" video") 
# 使 用 JavaScript ift i], iB id 18 DS VI RB KY 
# currentSrc [B TE $K ULA XC TÉ FI A6 FE AOI E 
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videoSrc = self.driver.execute scriptV 
("return arguments[0].currentSrc;", videoPlayer) 
# 打印 网 页 中 视频 存放 地 址 
print videoSrc 
e 肠 言 视频 存放 地 址 是 否 符合 预期 
self.assertEqual(videoSrc, "http://www. w3school. com. cn/i/movie.ogg" ) 
# (EJH JavaScript i4, 3 DH se VI RB KI 
# duration [S FEI IRH AE X fF KHE ATK 
videoDuration = self.driver.execute scriptV 
("return arguments[0].duration;", videoPlayer) 
# 打印 视频 时 长 
print videoDuration 
# 对 获取 到 的 视频 时 长 取 整 ,然后 扬言 是 否 等 于 3 秘 
self.assertEqual(int(videoDuration), 3) 
# (EJH JavaScript i 4, 38H b VEI HILARI RB ÁY 
# play OZ RKE AEH 
self. driver. execute_script(" return arguments[0].play();", videoPlayer) 
time. sleep(2) 
# dt 2 秘 后 ,使 用 JavaScript 语句 , il id WIE ne 
* 内 部 的 pause IRE TI EHI IET 
self.driver.execute script("return arguments[0].pause();", videoPlayer) 
EHI 3 Eo, AIEA TTA HUC DEBES 
tine. sleep(3) 
H HEPI P hE hk TE IT EIT ARBE, JE IR 4128 D EI] videoPlay pause. jpg X fF 
self. driver. save_screenshot("d:\\videoPlay pause. jpg" ) 


def tearDown(self): 
# iB ih ae 
self. driver. quit() 


if _name_ == ' main 


unittest. main() 


更 多 说 明 : 
控制 视频 播放 器 的 原理 均 需 要 使 用 JavaScript 语句 来 调用 视频 播放 器 内 部 的 属性 和 接 
口 来 完成 我 们 想 要 做 的 操作 。 


11.20 Mrs 





目的 : 

能 够 在 HTMLS 的 画布 上 进行 绘画 操作 。 

用 于 测试 的 网 址 : 

http://www. w3school. com. cn/tiy/loadtext.asp?f = html5 canvas line 
实例 代码 : 

encoding - utf - 8 


import unittest 
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from selenium import webdriver 


import time 


class TestDemo(unittest. TestCase): 
def setUp(self): 
* ENGL RE SEES] 3c fl 


self.driver = webdriver.Firefox(executable path = "c:Wgeckodriver") 


def test HTML5Canvas(self): 
url = "http://www. w3school. com. cn/tiy/loadtext.asp?f = html5 canvas line" 
# 访问 指定 的 网 址 
self.driver.get(url) 
# 调用 JavaScript iff], fk Jt i ihr Ei — fL LER 
# getElementBylId('myCanvas'); if] JW 9t ili E Bg Bl di JU 
# var cxt = c.getContext( '2d'); id iim 2d 
# cxt.fillStyle = '£Z FF0000'; EEH # FF0000 红色 
# cxt.fillRect(0, 0, 150, 150); ft ili fi Ee AE 
self.driver.execute script("var c = document.getElementById( 'myCanvas');" 
+ "var cxt = c. getContext( '2d');" 
+ "cxt.fillStyle- ' # FF0000';" 
+ "cxt.fillRect(0,0,150,150);") 
time. sleep(3) 
E HELHET E HEIE CILE TT RE, JE H8 26 D dif) HTMLSCanvas. jpg 
self.driver.save screenshot("d: WM HTML5Canvas. jpg" ) 


def tearDown(self): 
# iB ih NIE 
self. driver. quit() 


if _name_ == 


unittest. main( ) 


[md 和 HTML5 存储 对 象 


目的 : 

能 够 读 取 HTML5 的 localStorage 和 sessionStorage 的 内 容 , 并 删除 存储 的 内 容 。 
用 于 测试 的 网 址 : 

localStorage: 

http://www. w3school. com. cn/tiy/loadtext.asp?f - html5 webstorage local 


sessionStorage: 
http://www. w3school. com. cn/tiy/loadtext.asp?f = html5 webstorage session 


实例 代码 : 


# encoding = utf - 8 
from selenium import webdriver 
import unittest, time 
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class Htnl5Storage(unittest. TestCase): 


def setUp(self): 
# JAZ) Firefox Du w is 
self.driver = webdriver.Firefox(executable path- "c:\\geckodriver" ) 


def test Html5localStorage(self): 
# 指定 测试 localStorage 的 网 址 
localStorageUrl = V 
"http: //www. w3school. com. cn/tiy/loadtext.asp?f - html5 webstorage local" 
# 访问 localStorage [RH 
self.driver.get(localStorageUrl) 
tine. sleep(2) 
# 通过 JavaScript t], WRI IKTE 1ocalStorage 中 的 lastname [f] (ff. 
lastName = self.driver.execute script("return localStorage. lastname" ) 
print "lastName: ", lastName 
* OBERE EE A 4E y "Gates" 
self.assertEquals("Gates", lastName) 
# 通过 JavaScript iff fi] " localStorage. clear();" 
* 清除 万 有 存储 在 localStorage (Ili fr fili 
self.driver.execute script("localStorage. clear();") 
# 清除 存储 在 localStorage Ilf) fe filii P KAH lastnane H ffi 
last Name - self.driver.execute script("return localStorage. lastname" ) 
# OM EERENUM FE hii liie y None 
self.assertEquals(None, last Name) 


def test Html5SessionStorage(self): 
# 指定 sessionStorage 的 网 址 
sessionStorageUrl = V 
"http://www. w3school. com. cn/tiy/loadtext.asp?f - html5 webstorage session" 
# 访问 sessionStorage Kg fi 
self.driver.get(sessionStorageUrl) 
time. sleep(2) 
# muli Ee det, ibm x OS mx 
self.driver.find element by tag name("button").click() 
# 通过 JavaScript 语句 , 3k uff fifi fe sessionStorage 中 的 c1ickCount Hý ffi 
clickCount - self.driver.execute script("return sessionStorage. clickcount" ) 
print "clickCount = ", clickCount 
# M REREXUMS EET TTLID TP idi OK XC clickCount 变量 的 位 
self.assertEquals(1, int(clickCount)) 
# 通过 JavaScript 语句 , 清 队 存储 在 sessionStorage (P If] fe fil (fi 
self.driver.execute script("sessionStorage.clear();") 
# WERTE TE sessionStorage P hI fF fil [Hi er BEIK FEE clickCount ff [fi 
click count = self.driver.execute script("return sessionStorage. clickcount") 
£O EEUU TER ILIO Hid; XC click count 2E 4 hg fi 
self.assertEquals(None, click count) 


def tearDown(self): 
# 退出 Firefox Ù I ië 
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self.driver.quit() 


使 用 Chrome 浏览 器 自动 将 文件 下 载 到 指定 路 径 





目的 : 
通过 设 定 Chrome 属性 ,实现 脚本 自动 下 载 网 页 上 的 文件 ,并 保存 到 指定 路 径 下 。 
用 于 测试 的 网 址 : 





http://pypi. python. org/pypi/selenium 


实例 代码 : 


# encoding - utf - 8 
from selenium import webdriver 
import unittest, time 


class TestDemo(unittest. TestCase): 


def setUp(self): 
# 创建 Chrome W Vi fë Bc Prou $e Sic n] 
chromeOptions = webdriver.ChromeOptions() 
# BE FAX IH TRTE HUS C Al iDownload AR, 
# 如 时 该 月 录 不 存在 , 将 会 月 动 创 建 
prefs = ("download.default directory": "c: iDownload" } 
# ELE XCIE BER III fI Chrome 配置 对 象 实 例 中 
chromeOptions.add experimental option("prefs", prefs) 
# 启动 带 有 请 定义 设置 的 Chrome 浏览 各 
self.driver = webdriver.Chrome(executable path- "c: VV chromedriver" ,V 
chrome options = chromeOptions) 


def test downloadFileByChrome( self): 
url = "http://pypi. python. org/pypi/selenium" 
# 访问 将 要 下 载 文 件 的 网 址 
self.driver.get(url) 
# 我 到 要 下 载 的 文件 链 埠 页 面 元 素 , 并 音 击 进行 下 载 
self.driver.find element by partial link text\ 
("selenium - 3.0.2. tar.gz" ).. click() 
# PIF 100s, 以 便 文 件 下 载 完 成 
time. sleep(100) 


def tearDown(self): 
# 退出 Chrome W w sis 
self. driver. quit() 


if _name_ == ' main 


unittest.main() 
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目的 : 

通过 更 改 PC 端 Chrome 浏览 器 的 属性 值 ,将 PC 端 Chrome 浏览 器 设 定 为 手机 端 尺寸 
的 浏览 器 ,以 便 模拟 手机 端的 浏览 器 ,并 完成 各 种 页 面 操作 。 

用 于 测试 的 网 址 : 


http://www. baidu. com 
实例 代码 : 


#encoding= utf - 8 
from selenium import webdriver 
import unittest, time 








class TestDemo(unittest. TestCase): 


def test iPadChrone(self): 

options = webdriver.ChromeOptions() 

options.add argunent( 
' -- user - agent - Mozilla/5.0 (iPad; CPU OS 5 0 like Mac OS X) V 
AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 V 
Mobile/9A334 Safari/7534.48.3') 

driver = webdriver.Chrome(executable path- "c: WMV chromedriver", 

chrome options - options) 

driver. get (" http: //www. baidu. con" ) 

EON 3 E, ERE TE THOSE IC 

time. sleep(3) 

# HEET M IU TE Sfi A fie, fii A "iPad" 

driver.find element by id("kw"). send keys(" iPad") 

EOXÍE3ELATEERAUR 

time. sleep(1) 

# 通过 在 Chrome DI] W $8 JI JL E: 4i A. about: version, Zr fi (E46 SUR 

driver.get("about: version") 

# 人 工 确认 "用 户 代理 "项 配置 信息 是 否 跟 设置 一 样 

time. sleep(10) 

driver.quit() 


def test iPhoneChronme(self): 
options = webdriver.ChromeOptions() 
options.add argunent( 
' -- user - agent - Mozilla/5.0 (iPhone; CPU iPhone OS 5 0 like Mac OS X) V 
AppleWebKit/534.46 (KHTML, like Gecko) Version/5.1 V 
Mobile/9A334 Safari/7534.48.3') 
driver = webdriver.Chrome(executable path- "c: WV chromedriver", 
chrome options = options) 
driver. get ("http: //www. baidu. com" ) 
time.sleep(3) 
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# EIE A E, fii A "iPhone" 

driver.find element by id("index- kw").send keys("iPhone") 
time.sleep(1) 

# 通过 在 Chrome J| W 2$ JI i F: (1 fii A about version, 查看 伪装 效果 
driver.get("about: version") 

# 人 工 确认 "用 户 代理 "项 配置 信息 是 否 和 设置 一 样 

time. sleep(10) 

driver.quit() 


def test Android236Chrone(self): 
options = webdriver.ChromeOptions() 
options.add argument( 
' -- user - agent = Mozilla/5.0 (Linux; U; Android 2.3.6; en- us; V 
Nexus S Build/GRK39F)  AppleWebKit/533.1 V 
(KHTML, like Gecko) Version/4.0 Mobile Safari/533.1') 
driver = webdriver.Chrome(executable path = "c: VV chromedriver", 
chrome options - options) 
driver. get ("http: //www. baidu. com" ) 
tine.sleep(3) 
# SITIS: ig A HE, fii A "Android 2. 3. 6" 
driver.find element by id("index- kw").send keys("Android 2.3.6") 
time. sleep(1) 
# 通过 在 Chrome W i d I lE E: rdi A. about: version, frr ff 3€ UR 
driver.get("about: version") 
# ATA "用户 代 理 " 项 配置 信息 是 否 和 设置 一 样 
time. sleep(10) 
driver.quit() 


def test Android402Chronme(self): 

options - webdriver.ChromeOptions() 

options.add argunent( 
' -- user - agent - Mozilla/5.0 (Linux; U; Android 4.0.2; V 
en- us; Galaxy Nexus Build/ICL53F)  AppleWebKit/534.30 V 
(KHTML, like Gecko) Version/4.0 Mobile Safari/534.30') 

driver = webdriver.Chrome(executable path- "c: Wchromedriver", 

chrome options - options) 

driver.get("http://www. baidu. com" ) 

tine. sleep(3) 

# SITE dCi A TIE, fi A "Android 4.0.2" 

driver.find element by id("index- kw").send keys("Android 4.0.2") 

time. sleep(1) 

# 通过 在 Chrome Ji] W S5 JI iL F: rf dii A. about : version, t fr MRAR 

driver.get("about: version") 

# ATHA "用 户 代 理 " 项 配置 信息 是 否 和 设置 一 样 

time. sleep(10) 

driver. quit() 


' main ': 


if name  -- 


unittest.main() 
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代码 解释 : 

通过 --useragent 一 "xxx" 来 修改 HTTP 请 求 头 部 的 Agent 字符 串 , 以便 将 PC 端的 
Chrome 浏览 器 伪装 成 手机 浏览 器 。 同 时 通过 在 Chrome 地 址 栏 中 输入 "about: version” X 
查看 修改 效果 。 


屏蔽 Chrome 的 - -ignore-certificate-errors 提示 及 


本 禁用 扩展 插件 并 实现 窗口 最 大 化 





目的 : 

屏蔽 WebDriver 启动 Chrome 实例 时 总 出 现 的 “--ignore-certificate-errors” 提 示 信 息 ， 
同时 禁用 Chrome 浏览 器 的 插件 ,并 且 让 浏览 器 窗口 最 大 化 。 

用 于 测试 的 网 址 : 


http://www. baidu. com 


实例 代码 : 


# encoding - utf - 8 

from selenium import webdriver 

from selenium. webdriver. chrome. options import Options 
import unittest, time 


class TestDemo(unittest. TestCase) : 


def setUp(self): 
# 创建 Chrome W Vi 2$ 0] — f- Options 实例 对 和 象 
chrome options = Options() 
# 向 Options 实例 中 添加 禁用 扩展 插件 的 设置 参数 项 
chrome options.add argument(" -- disable - extensions") 
# 添加 屏蔽 -- ignore- certificate - errors 提示 信息 的 设置 参数 项 
chrome options.add experimental option("excludeSwitches", 
[" ignore - certificate - errors"]) 
# aou i de RC MEI EE PE n, 一 启动 就 最 大 化 
chrome options.add argument(' -- start - maximized') 
# 启动 带 有 自 人 定义 设 置 的 Chrome Wy W as 
self.driver = webdriver.Chrome(executable path="c:\\chromedriver", 
chrome options = chrome options) 


def test extendedAttributesChrome(self): 
# 访问 百度 首页 
self. driver. get ("http: //www. baidu. com" ) 
# OHIE3ELA TES EHAS EAE 
time. sleep(3) 
# 找到 页 面 的 搜索 给 人 框 , 输 人 " 光 业 之 路 自动 化 测试 ” 
self. driver. find_element_by_id("kw").send_keys(u" 光 荣 之 路 自动 化 测试 ") 
time. sleep(2) 


- 228 - 




















的 扩 


11 


第 11 章 ”WebDriver 高 级 应 O, 
def tearDown(self): 


# 退出 Chrome Ù) 9i d$ 
self.driver.quit() 


if name == ' main ': 


unittest.main() 
更 多 说 明 : 
可 以 通过 在 Chrome 浏览 器 地 址 栏 中 输入 “chrome://extensions/” 后 回 车 ,查看 已 安装 
展 应 用 。--ignore-certificate-errors 提示 只 在 Chrome 部 分 版 本 中 存在 。 








.25 禁用 Chrome es 


目的 : 
禁用 Chrome 浏览 器 的 PDF 和 Flash 插件 ,本 实例 包含 了 11. 23 节 的 功能 。 
用 于 测试 的 网 址 : 


http://www. iqiyi. com 


实例 代码 : 


#encoding= utf -8 

from selenium import webdriver 

# FA Options 类 

from selenium. webdriver. chrome. options import Options 
import unittest, time 


class TestDemo(unittest. TestCase): 


def setUp(self): 
£ 创建 Chrome XJ W 2: /f] — f Options 实例 对 和 象 
chrome options - Options() 
# 设置 Chrome Di] Vi 2$ 35H PDF fll Flash fifi fF 
profile - ("plugins.plugins disabled": 
['Chrome PDF Viewer', 'Adobe Flash Player']} 
chrome options.add experimental option("prefs", profile) 
# 向 Options 实例 中 添加 禁用 扩展 插件 的 设置 参数 项 
chrome options.add argument(" -- disable - extensions") 
# 添加 屏蔽 —— ignore - certificate - errors 提示 信息 的 设置 参数 项 
chrome options.add experimental option("excludeSwitches" , 
[" ignore - certificate - errors" ]) 
# MIU TELE CA HEB EE PE BOE, 启动 局 时 最 大 化 窗口 
chrome options.add argument(' -- start - maximized') 
# RSS EXE X BHY Chrome W w ë 
self.driver = webdriver.Chrone(executable path- "c:\\chromedriver", 


chrome options - chrome options) 


def test forbidPdfFlashChrome(self): 
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# We zÓg 

self.driver.get("http: //www. iqiyi. com" ) 

# EIF 50 EP, W OA PA kih FHT Flash diff, 
# 时 致 需要 Flash 支持 的 内 答 无 法 正常 展示 

time. sleep(10) 

* 查看 PDF $ Flash thft Mti v 

self. driver. get (" chrome: //plugins/" ) 

time. sleep(20) 


def tearDown(self): 
# 退出 Chrome Ù% di 
self.driver.quit() 


if name  -- ' main ': 


unittest.main() 


更 多 说 明 : 
本 实例 只 提供 了 常用 的 禁用 PDF 和 Flash 插件 项 ,如 果 读 者 有 更 多 Chrome 参数 项 需 
求 , 请 自行 上 网 搜索 查看 。 


11.26 MERE MISES EL EE En 


目的 : 
关闭 IE 的 保护 模式 ,使 自动 化 实施 过 程 更 方便 。 
实例 代码 : 


#encoding= utf -8 

from selenium import webdriver 

from selenium. webdriver.common.desired capabilities import DesiredCapabilities 
import unittest, time 


class TestDemo(unittest. TestCase): 


def setUp(self): 
caps = DesiredCapabilities. INTERNETEXPLORER 
# 将 忽略 正 保 护 模式 的 参数 设置 为 True 
caps['ignoreProtectedModeSettings'] = True 
# 启动 带 有 自任 义 设置 的 IENIS 
self. driver = webdriver.le(executable path="c:\\IEDriverServer", 
capabilities = caps) 


def test closeThelEProtectedMode( self): 
# 访问 百度 首页 
self.driver.get("http://www. baidu. com" ) 


tine. sleep(2) 


def tearDown(self): 
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# 退出 IE 


self. driver. quit() 


if name == ' main ': 


unittest. main( ) 


11.27 Eb/ :Ea E dT ee 





目的 : 
在 WebDriver 启动 Firefox 浏览 器 的 同时 ,打开 Firebug 插件 ,以 便 调 试 之 用 。 
环境 准备 ; 


CD 先 按照 11. 10 节 所 介绍 的 “生成 用 户 自 定义 的 Firefox 浏览 器 配置 文件 ”步骤 创建 
一 个 新 的 Firefox 配置 文件 (比如 名 叫 WebDriver) 。 

(2) 创建 好 自 定义 配置 文件 后 ,选择 该 配置 文件 启动 Firefox 浏览 器 , 单 击 浏览 器 窗口 
右上 角 的 e 图 标 ,在 弹出 的 菜单 中 , 单 击 “ 附 加 组 件 ” 选 项 ,如 图 11-17 所 示 , 在 接 下 来 的 页 
面 中 , 单 击 左边 菜单 栏 的 “扩展 ”进入 插件 搜索 页 面 ,然后 在 附件 搜索 输入 框 中 输入 
“firebug” 回 车 ,等 待 几 秒 会 加 载 Firebug 插件 ,如 图 11-18 Bros s 然后 单 击 Firebug 插件 右 
边 的 安装 按钮 进行 Firebug 插件 安装 。 如 果 需 要 离线 的 Firebug 插件 文件 ,可 以 直接 访 
https://getfirebug. com/releases/firebug/ 网 站 进行 下 载 。 





打印 历史 记录 全 屏 


开发 者 同步 的 标签 页 
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RE amma 9 ammm 
Firebug a 搜索 到 的 Firebug 插 件 muna $ 
PP predug 2/083 Fielox BATAAR IA. OER CSS. HTML ES 
Firebug Autocompleter maenana 
Firebug command line autocomplete ES — 
mema 
CodeBurner for Firebug n a — 





CodeBurner is a Firefox add-on that integrates with Firebug. to extend it with reference material for HTM_ (P$ 


图 1118 


实例 代码 : 


£ encoding - utf - 8 

from selenium import webdriver 

import unittest, time 

from selenium. webdriver. common. keys import Keys 


class TestDemo(unittest. TestCase): 


def test openFireBug(self): 
* RE ELE X REX IEEE 
profilePath = r'C: \Users\ SR\ AppData\ Roaming M Mozilla \ Firefox \ Profiles| 3onuufut. 
addfirebug' 
# H HEX EXIFMRE]J FirefoxProfile 实例 中 
profile = webdriver. firefox. firefox_profile. FirefoxProfile(profilePath) 
# 将 添加 了 新 配置 文件 的 Firefox DU VI 8$ EF WA FERE E RC, 
# DUBEELSI Ede ri E EEEE BE FE EY FT BE BEC 
profile.set preference("browser. startup. homepage" , 
"http://www. baidu. con" ) 
# OBEBUEUSENL E EDU RTI 3E EAS Dur s PLC 
profile.set preference("browser. startup. page", 1) 
# 摇动 打开 Firebug 
profile. set_preference(" extensions. firebug. allPagesActivation", "on") 
# 启用 firebug [J44 li fic I) hE 
profile. set_preference(" extensions. firebug. net. enableSites", True) 
# 启用 firebug Cookies 面板 功能 
profile. set_preference("extensions. firebug. cookies. enableSites", True) 
zB AEX MR AEH Firefox UI is 
driver = webdriver. Firefox(executable_path = "c: \\geckodriver", 
firefox_profile = profile) 
# EIE DU VE AESA E E È 
time. sleep(3) 
# RAE E WIDPSISS i A HEHE 
input = driver.find element by id("kw") 
# FETU SH A Edi A "selenium" 
input. send keys(" selenium" ) 
# input.send keys(Keys.F12) 
# FIF 30 Eb, 人 工厂 认 上 面 一 系列 设置 是 否 生 效 


- 22 - 

















第 11x WebDriver 高 级 应 用 


time. sleep(30) 
driver.quit() 


if name == ' main ': 


unittest.main() 


代码 解释 : 

上 面 代码 执行 后 ,会 在 启动 Firefox 浏览 器 后 , 自动 打开 Firebug 面板 ,并 且 开 启 
Firebug 面板 中 的 网 络 和 Cookies 面板 功能 。 实 例 代码 中 被 注释 的 语句 input. send. keys 
(Keys. F12) 表 示 在 找到 的 搜索 输入 页 面 元 素 上 模拟 键盘 按 下 F12 键 ,效果 等 价 于 手工 在 
Firefox 浏览 器 中 按 F12 键 。 其 作用 等 价 于 profile. set preference ("extensions. firebug. 
allPagesActivation", "on"), 二 者 可 以 取 其 一 。 

更 多 说 明 : 

在 Firefox 43 及 更 高 版 本 中 ,Firefox 将 阻止 用 户 安装 未 签名 的 附加 组 件 , 并 禁用 任何 
已 安装 的 未 签名 附加 组 件 ( 例 如 本 例 中 的 Firebug 插件 等 ), 通 过 本 节 实 例 的 方法 可 以 彻底 
绕 过 Firefox 烦人 的 通行 证 问题 ,用 户 只 需要 新 创建 一 个 Firefox 配置 文件 ,然后 在 以 这 个 
配置 文件 启动 的 Firefox 浏览 器 中 安装 好 需要 的 附加 组 件 , 脚 本 中 使 用 该 配置 文件 启动 
Firefox 浏览 器 即 可 解决 直接 通过 profile. add. extension (" D; WV firebug-2. 0. 18. xpi") 这 样 
的 方式 添加 的 附件 组 件 被 禁用 的 问题 。 





EM 





11.28. EKOO Me :inte 由 





目的 : 
禁用 Chrome 浏览 器 的 图 片 加 载 , 使 访问 的 网 页 加 载 更 迅速 。 
实例 代码 : 


#encoding= utf -8 
from selenium import webdriver 
from selenium. webdriver. chrome. options import Options 


import time 


class TestDemo(unittest. TestCase) : 
def setUp(self): 
* 创建 Chrome 浏览 豆 的 一 个 Options 实例 对 象 
chrome options = Options() 
# BEBE chrome 28 JH [8 Hr mhi 
prefs = ("profile.managed default content settings. images": 2} 


# Gn BE ilit chrome 浏览 天 禁用 图 片 的 设置 


chrome options.add experimental option("prefs", prefs) 
# AAMA AEX RAKY Chrome W) 6 ik 
self.driver = webdriver.Chrome(executable path="c:\\chromedriver", 


chrome options = chrome options) 


def test forbidImageChrome(self): 
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# WB B 
self.driver.get(" https: //www. taobao. con/" ) 


# IF SO b, 期间 可 以 看 到 页 面 由 于 禁 爵 了 图 片 加 载 , 
# 时 致 图 片 均 无 法 正常 展 示 

time. sleep(10) 

self.driver.quit() 


def tearDown(self): 
# 退出 Chrome Ù% d 
self.driver.quit() 


if name  -- 
unittest.main() 


11.29 BE-3 T bc ESSI BS DM eT [ES 





目的 : 
禁用 Firefox 浏览 器 的 CSS Flash 及 图 片 加 载 , 使 访问 的 网 页 加 载 更 迅速 。 
实例 代码 : 


# encoding - utf - 8 
from selenium import webdriver 


import time 


class TestDemo(unittest. TestCase) : 
def setUp(self): 
# 创建 Firefox WI d$ [fJ — 1- Options Sc fn] x] $e 


profile - webdriver.FirefoxProfile() 


# AE CSS Judi 

profile. set_preference(" permissions. default. stylesheet", 2) 

# 4J images 加 裁 

profile. set_preference(" permissions. default. image", 2) 

# H Flash fh fH 

profile.set preference(" dom. ipc. plugins. enabled. libflashplayer. so", 
False) 


# 启动 带 有 有 自 定 义 设置 的 Chrome W W Ar 
self.driver = webdriver.Firefox(executable path = "c:\\geckodriver", 
firefox profile = profile) 


def test forbidImageChronme(self): 
# 芒 问 爱 奇 艺 首页 
self.driver.get("http: //www. iqiyi. com" ) 


# FIF 50 Eb, 期 间 可 以 看 到 页 面 由 于 禁用 了 Flash 插件 .图 片 及 CSS m, 


# 导致 页 面 无 法 正常 展示 
time. sleep(10) 
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self. driver. quit() 


def tearDown(self): 
# iBih Firefox Ù wis 
self. driver. quit() 


if name == ' main ': 


unittest.main() 
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(D= 数据 驱动 测试 


数据 驱动 测试 是 自动 化 测试 中 的 主流 设计 模式 之 一 ,属于 中 级 自动 化 测试 工程 师 必 备 
知识 ,必须 深入 掌握 数据 驱动 测试 的 工作 原理 和 实现 方法 。 


12.1 EE thg 


相同 的 测试 脚本 使 用 不 同 的 测试 数据 来 执行 ,测试 数据 和 测试 行为 完全 分 离 ,这 样 的 测 
试 脚本 设计 模式 称 为 数据 驱动 。 pra 自动 化 测试 工程 师 想 验 证 不 同 
的 用 户 名 和 密码 在 网 站 登录 时 对 系统 影响 结果 ,就 可 以 使 用 数据 驱动 模式 来 进行 自动 化 
测试 。 

实施 数据 驱动 测试 步骤 如 下 : 

(1) 编写 测试 脚本 ,脚本 需要 支持 从 程序 对 象 , 文 件 或 数据 库 读 人 测试 数据 。 

C2) 将 测试 脚本 使 用 的 测试 数据 存 人 程序 对 象 文件 或 数据 库 等 外 部 介质 中 。 

(3) 运行 脚本 过 程 中 ,循环 调用 存储 在 外 部 介质 中 的 测试 数据 。 

(4) 验证 所 有 的 测试 结果 是 否 符合 预期 结果 


12.2 WESCE SUE SES E. 





本 书 中 Python 数据 驱动 单元 测试 是 将 unittest 和 ddt 模块 结合 起 来 实现 的 。 下 面 介 
绍 一 下 ddt 模块 的 安装 步 又 。 

(1) 在 “开始 ”>“ 搜 索 程 序 和 文件 " 框 中 输入 *CMD” 并 回 车 ,然后 在 打开 的 CMD 窗口 
中 输入 “pip install ddt” 并 回 车 ,进行 ddt 模块 的 安装 。 

(2) 等 安装 进度 条 走 完 ,在 CMD 下 输入 “python” 进 入 python 交互 模式 ,执行 “import 
ddt” ,如果 未 报错 ,说 明 ddt 模块 已 安装 成 功 。 

使 用 pip 不 能 成 功 安 装 的 读者 .可 以 直接 访问 https://pypi. python. org/pypi/ddt 下 载 
ddt 的 源码 包 进 行 安 装 , 如 图 12-1 所 示 。 

解压 下 载 好 的 压缩 包 到 某 个 目录 ,然后 将 CMD 当前 工作 目录 切换 到 setup. py 文件 所 
在 目录 ,并 执行 “python setup. py install” 进 行 ddt 模块 的 安装 。 如 图 12-2 所 示 。 

等 待 安装 完成 ,验证 ddt 模块 是 否 安装 成 功 的 方法 请 参阅 上 面 pip 安装 时 的 检测 方法 。 
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Package Index > ddt > 1.11 


ddt 1.1.1 


Data-Driven/Decorated Tests e 


A library to multiply test cases 


File Type Py Version 
ddi-1 1.1-py2 py3-none-any wh! (md5) Python Wheel 35 
Gdt-1 1.1targz (md57 人 一 ii iti F ik Source 


工作 目录 切换 到 setup.py 文 件 所 在 
目录 


— 


1253 用 unittest 和 ddt 





测试 逻辑 : 

(1) 打开 百度 首页 

(2) 在 搜索 框 输入 一 个 搜索 关键 词 
(3) 单 击 搜索 按钮 





试 执行 失败 ,并 在 测试 过 程 中 打印 日 志 
实例 代码 : 


£ encoding= utf -8 

from selenium import webdriver 
import unittest, time 

import logging, traceback 
import ddt 


from selenium. common. exceptions import NoSuchElementException 


# WIH EHR 
logging. basicConfig( 

# HG 

level = logging. INFO, 
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# HERR 

* 时间 ,代码 所 在 文件 各、 代码 行 号、 日 志 级 别 和 名字、 日志 信 息 

format = '% (asctime)s % (filename)s[line: % (lineno)d] % (levelname)s % (message)s', 
# FTE HEAR 

datefmt = '%a, %d %b $Y %H:%M:%S', 

# 日 志文 件 存 放 的 目录 (目录 必须 存在 ) 及 日 志文 作 和 名 

filename = 'd:/DataDrivenTesting/report.log', 

# 打开 日 志文 件 的 方式 

filemode = 'w' 


) 


(à ddt. ddt 
class TestDemo(unittest. TestCase): 
def setUp(self): 
self.driver = webdriver.Firefox(executable path = "c: WV geckodriver" ) 


@ddt. data([u" 神奇 动物 在 哪里 "，u 叶 茨 "]， 
[uw 疯狂 动物 城 "，u" 古 德 温 " ] , 
[wn 大 话 西游 之 月 光 宝 盒 ", uw 周星驰 " ] ) 
@ddt. unpack 
def test dataDrivenByObj(self, testdata, expectdata): 
url = "http://www.baidu. com" 
# 访问 百度 首页 
self.driver.get(url) 
# BERSE 10 E 
self.driver. implicitly wait(10) 
try: 
ERUIT Sei A e, 并 给 人 测试 数据 
self.driver.find element by id("kw").send keys(testdata) 
# RIRE, HA i 
self.driver.find element by id("su").click() 
time. sleep(3) 
E OB PE ERE A HL BAE CIR FCD 
self.assertTrue(expectdata in self.driver.page source) 
except NoSuchElementException, e: 
logging. error(u" 查 找 的 页 面 元 素 不 存在 ,异常 堆栈 信息 : ” 
+ str(traceback.format exc())) 
except AssertionError, e: 
logging. info(u" f S" * s", ME" S s", AK WE". s (testdata, expectdata)) 
except Exception, e: 
logging. error(u" 未 知 错误 ,错误 信息 : ”+ str(traceback. format exc())) 
else: 
logging. info(u' 搜索 " % s", 期望 "% s"j jd" % (testdata, expectdata)) 


def tearDown( self) : 
self.driver.quit() 


' main ': 


if name ee P 


unittest.main() 
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执行 结束 后 打印 的 日 志文 件 内 容 : 


Tue, 06 Dec 2016 16:59:56 dataDriver.py[line:54] INFO 搜索 "神奇 动物 在 哪里 ", 期望 " 叶 茨 "通过 

Tue, 06 Dec 2016 17:00:09 dataDriver.py[line:54] INFO 搜索 "疯狂 动物 城 ", 期 望 " 古 德 温 "通过 

Tue, 06 Dec 2016 17:00:24 dataDriver. py[line:54] INFO 搜索 "大 话 西游 之 月 光 宝 盒 ", 期望 " 周 星 

驰 " 通 过 

代码 解释 : 

在 unittest 中 结合 ddt 实现 数据 驱动 ,首先 是 在 头 部 导入 ddt 模块 (import ddt) ,其 次 在 
测试 类 TestDemo 前 声明 使 用 ddt(@ddt. ddt) ,然后 在 测试 方法 前 使 用 @ddt. data() 添 加 该 
测试 方法 需要 的 测试 数据 ,@ ddt. data 接收 一 个 可 和 迭代 的 类 型 ,以 此 来 判断 需要 执行 的 次 
数 。 多 组 测试 数据 间 以 逗号 隔 开 (比如 @ddt. ddt(3,1,5,6))。 如 果 每 组 测试 数据 存在 多 个 
测试 数据 ,需要 将 每 组 数据 存 于 列表 中 ,比如 本 节 实 例 中 的 @ddt. data(Lu" 神 奇 动 物 在 哪 
里 ",u" 叶 菊 "],[u" 疯 狂 动 物 城 ",u" 古 德 温 "],Lu" 大 话 西游 之 月 光 宝 盒 ", u" 周 星 驰 "])， 
表示 存在 三 组 数据 ,每 组 数据 中 的 数据 与 测试 方法 中 定义 的 形 参 个 数 及 顺序 一 一 对 应 。 最 
后 使 用 @unpack 进行 修饰 ,也 就 是 在 测试 方法 被 调用 过 程 中 ,对 测试 数据 进行 解 包 , 将 每 组 
测试 数据 中 的 第 一 个 数据 传 给 testdata 形 参 ,将 每 组 测试 数据 中 的 第 二 个 测试 数据 传 给 
expectdata 形 参 。 

由 此 在 脚本 执行 过 程 中 ,会 根据 提供 的 三 组 测试 数据 三 次 打开 浏览 器 ,分 别 输入 三 个 不 
同 的 搜索 词 进行 查询 ,并 在 三 次 搜索 结果 中 断言 是 否 出 现 期 望 的 结果 数据 。 


12.4 REE ARATE EE 





测试 逻辑 : 
CD 打开 百度 首页 。 
D 从 扩展 名 为 json 的 文件 中 读 出 测试 相关 数据 ,并 将 要 查询 的 数据 输入 搜索 框 中 。 
(3) 单 击 搜索 按钮 。 
CD. 断言 搜索 结果 页 面 是 否 包含 文本 文件 中 提供 的 预期 关键 字 串 ,包含 则 认为 测试 执 
行 通过 ,否则 认为 测试 执行 失败 ,并 生成 自 定义 的 HTML 测试 报告 。 
测试 数据 文件 准备 : 
PyCharm 中 新 建 一 个 名 叫 DataDrivenProject 的 Python 工程 ,在 该 工程 下 新 建 test_ 
data list. json, Report Template. py 以 及 DataDrivenTest. py 三 个 文件 。 
文件 test. data. list. json 用 于 存放 测试 所 需要 的 测试 数据 ,具体 内 容 如 下 : 
[ 
"JA", 
"乔丹 | | 迈克 尔 "， 
"ENS, 
" 杜 兰 特 | | 凯 文 "， 
"詹姆斯 | | 勒 布朗 ” 
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查询 关键 词 和 期 望 出 现 的 关键 词 用 "||? 分 隔 , 多 组 数据 ,以 逗号 隔 开 存 于 列表 中 。 如 果 
直接 用 文本 编辑 器 创建 该 文件 ,需要 将 文件 保存 为 utf8 编码 的 格式 ,否则 中 文 会 出 现 
乱码 。 

实例 代码 : 

ReportTemplate. py 文件 ,用 于 生成 自 定义 HTML 测试 报告 ,具体 内 容 如 下 : 


# encoding - utf - 8 


def htmlTemplate(trData): 

htmlStr = u'''«!DOCTYPE HTML» 

< html > 

<head> 

<title > 单元 测试 报告 </title> 

<style> 

body { 
width: 805; / * 整个 body 区 域 占 浏览 器 的 宽度 百分比 * / 
margin: 40px auto; / * 整个 body 区 域 相对 浏览 器 窗口 摆 放 位 置 (左右 , 上 下 ) * / 
font- weight: bold; / * 整个 body 区域 的 字体 加 粗 * / 
font- family: 'trebuchet MS', 'Lucida sans', SimSun; / » 表格 中 文字 的 字体 类 型 * / 


font- size: 18px; /* 表格 中 文字 字体 大 小 * / 
color: #000; / * 整个 body 区 域 字体 的 颜色 */ 
} 
table { 


* border - collapse: collapse; /* 合并 表格 边框 * / 
border - spacing: 0; /* 表格 的 边框 宽度 * / 
width: 100 $ ; /* 整个 表格 相对 父 元 素 的 宽度 */ 
} 
.tableStyle ( 
/ * border: solid # ggg 1px; * / 
border - style: outset; — / * 整个 表格 外 边框 样式 * / 
border - width: 2px; /* 整个 表格 外 边框 宽度 / 
/ * border: 2px; * / 
border - color: blue; /* 整个 表格 外 边框 颜色 * / 
) 
.tableStyle tr:hover ( 
background: rgb(173, 216,230); /* 鼠标 滑 过 一 行 时 ,动态 显示 的 颜色 146,208,80 « / 
} 


.tableStyle td, .tableStyle th { 
border- left: solid 1px rgb(146,208,80); /* 表格 的 坚 线 颜 色 * / 
border - top: 1px solid rgb(146, 208,80);  / = 表格 的 模 线 颜色 x / 
padding: 15px; / * 表格 内 边框 尺寸 * / 
text- align: center; /* 表 格 内 容 显示 位 置 * / 

.tableStyle th ( 


padding: 15px; /* 表格 标题 栏 ,字体 的 尺寸 * / 
background - color: rgb(146,208,80); /* 表格 标题 栏 背景 颜色 * / 
/* 表 格 标题 栏 设置 渐变 颜色 * / 
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background- image: - webkit - gradient(linear, left top, left bottom, from( # 92D050), to 
( € A2D668)); 
/ * rgb(146,208,80) « / 
) 
«/style» 
</head> 
< body> 
< center >< hl > 测试 报告 </hl » «/center»« br /> 
< table class = "tableStyle"» 
< thead > 
«tr» 
< th» Search Words «/th» 
< th» Assert Words «/th» 
«th» Start Tine «/th» 
< th» Waste Tine(s)«/th» 
< th» Status </th > 
</tr> 
«/thead»''' 
endStr = u''' 
«/table» 
</body> 
«/htnl»''' 
# 拼接 完整 的 测试 报告 HTML 页 面 代码 
html = htmlStr + trData + endStr 
print html 
# 生成 .html 文件 
with open(r"D:VbookVtestTemplate. html", "w") as fp: 
fp. write(html. encode(" gbk" ) ) 


DataDrivenTest. py 文件 ,用 于 编写 数据 驱动 测试 脚本 ,具体 内 容 如 下 : 


# encoding= utf - 8 
from selenium import webdriver 

import unittest, time 

import logging, traceback 

import ddt 

from ReportTenplate import htnlTemplate 

from selenium. common. exceptions import NoSuchElementException 


# WHER 

logging. basicConfig( 
# HERH 
level = logging. INFO, 
# Hist 
# HEE ABEX ABG. H ERIE F. H EAE 
format = '% (asctime)s % (filename)s[line: % (lineno)d] % (levelname)s % (message)s', 
# 打印 日 志 的 时间 
datefmt = '%a, $Y- %m- %d $H:$M:$5', 
€ 日 志文 件 存 放 的 目录 (目录 必须 存在 ) 及 日 志文 件 名 
filename = 'd:/DataDrivenTesting/report.log', 


: 242; 


第 12 章 数据 驱动 测试 (5 


# 打开 日 志文 件 的 方式 
filemode = 'w' 


@ddt. ddt 
class TestDemo(unittest. TestCase): 


(à classmethod 
def setUpClass(cls): 
# 整个 测试 过 程 只 被 调用 一 次 


TestDemo.trStr - "" 


def setUp(self): 
self.driver = webdriver.Firefox(executable path = "c: V geckodriver" ) 
status = None # M T ff JC B bUIA AF ARS, KM 'fail', MI 'pass' 
flag = 0 # KI AWARI, 失败 置 0, 成功 置 1 


@ddt. file data("test data list. json") 

def test dataDrivenByFile(self, value): 
# AEWRE TUR S Oc TP A EM EE 
flagDict = (0: 'red', 1: '# O0ACAE'] 


url - "http://www. baidu. com" 

# 访问 百度 首页 

self.driver.get(url) 

EOD E T ORREK 

self.driver.maximize window() 

print value 

# 将 从 . json 文件 中 读 取 出 的 数据 用 "| LETT IHR 0 DUE 
# 和 期 望 数 据 

testdata, expectdata = tuple(value. strip().split("||")) 
# 设置 不 式 等 符 肝 间 为 10 秘 


self. driver. implicitly wait(10) 


try: 
# 获取 当前 的 时间 越 , 用 于 后 面 计算 查询 耗 时 用 
start = time.time() 
# GN ni Dp a] PO FIER, 表示 测试 开 奴 时间 
startTime = time.strftime(" $Y- %m- %d %H: $M: % S", tine. localtine()) 
# 找到 搜索 给 人 奏 , 并 给 人 测试 数据 
self. driver. find element by id("kw").send keys(testdata) 
# RIRE M, JE Yd; 
self.driver.find element by id("su").click() 
time. sleep(3) 
BON T A ARAE T th PA TE UR (C3 P 
self.assertTrue(expectdata in self.driver.page source) 
except NoSuchElementException, e: 
logging. error(u" 查 找 的 页 面 元 素 不 存在 ,异常 堆栈 信息 :“" 
+ str(traceback. format exc())) 
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except AssertionError, e: 
logging. info(u'ig R" $ s", Hj EB" $ s", 失败”% (testdata, expectdata)) 
status = 'fail' 
flag - 0 
except Exception, e: 
logging. error(u" 未 知 错误 ,错误 信息 : ”+ str(traceback.format exc())) 
status = 'feil' 
flag - 0 


logging. info(u' HR R" % s", HÆ" % s" 通 过 " % (testdata, expectdata)) 
Status - 'pass' 
flag - 1 
# OTEEEREBI, MOFEIEIOEGIE fi A SA A HE PEI zy B R D RI FERT 
wasteTime = time.time() - start - 3 £ M Xd $3 
# od — HEIN TAE EL BIER IAE [EL BA RIT 
# 的 HTML 代码 中 ,并 将 这 些 行 HIML 代码 拼接 到 变量 trStr 变量 由 
EOS BCEGIBE TE BERI IGI CR, f£ A btnITenplate() jp trf 
# ERE WIRE HY HTML 代码 
TestDemo.trStr += U 
<tr> 
«td» %s</td> 
«td» 5$s«/td» 
«td» 5$s«/td» 
«td» $.2£«/td» 
< td style = "color: % s"> $ s«/td» 
</tr><br />''' % (testdata, expectdata, startTime, 
wasteTime, flagDict[flag], status) 


def tearDown(self): 


self.driver.quit() 


(à classmethod 
def tearDownClass(cls): 


# G AEX HY HTML 测试 报告 
# 整个 测试 过 程 只 被 调用 一 次 
htmlTemplate( TestDemo. trStr) 


if nane == ' main 


unittest.main() 


执行 结束 后 打印 的 日 志文 件 内 容 : 


Wed, 
Wed, 
Wed, 
Wed, 
Wed, 


2016-12-07 10:07:51 dataDriver.py[line:53] INFO 搜索 "邓肯 ", 期 望 " 蒂 姆 "通过 
2016-12-07 10:08:06 dataDriver.py[line:53] INFO 搜索 "乔丹 ", 期 望 "迈克 尔 " 通 过 
2016-12-07 10:08:20 dataDriver.py[line:53] INFO 搜索 " 库 里 ", 期 望 " 斯 蒂 芬 "通过 
2016-12-07 10:08:34 dataDriver.py[line:53] INFO 搜索 " 杜 兰 特 ", 期 望 " 凯 文 "通过 
2016-12-07 10:08:48 dataDriver.py[line:53] INFO 搜索 "詹姆斯 ", 期 望 " 勒 布朗 "通过 


生成 的 HTML 测试 报告 内 容 如 图 12-3 所 示 。 
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测试 报告 


2016-12-07 11:34:45 
2016-12-07 11:34:59. 


2016-12-07 11:35:15 


2016-12-07 11:35:29 


2016-12-07 11:35:44 





图 12-3 


代码 解释 : 

在 测试 方法 test_dataDrivenByFile 上 使 用 @ddt. file_data() 装 饰 该 测试 方法 ,目的 是 为 
测试 方法 提供 存放 在 文件 test. data list. json 里 的 测试 数据 ,文件 里 的 数据 通过 列表 包裹 ， 
而 列表 中 每 一 个 元 素 代表 一 组 测试 数据 ,比如 “邓肯 | | 带 姆 "属于 第 一 组 测试 数据 ,也 就 是 程 
序 第 一 次 调用 test_dataDrivenByFile 测试 方法 时 传 入 的 数据 。 测 试 脚 本 依次 从 test_data_ 
list. json 文件 中 的 列表 中 取出 需要 测试 的 数据 ,并 记录 每 次 测试 开始 时 间 , 耗 时 以 及 测试 结 
果 , 最 后 将 测试 结果 信息 组 装 成 HTML 代码 进行 展示 ,如 图 12-3 所 示 。 

更 多 说 明 : 

存放 测试 数据 的 文件 也 可 以 是 . txt 等 类 型 的 文件 ,在 文件 中 除了 将 测试 数据 包 庄 在 列 
表 中 ,还 可 以 使 用 字典 对 象 进行 包装 ,详细 使 用 方法 请 参看 http://ddt. readthedocs. io/en/ 
latest/example. html, 


备 选 方法 : 


£ encoding = utf - 8 

from selenium import webdriver 

import unittest, time 

import logging, traceback 

import ddt 

import HTMLTestRunner 

from selenium. common. exceptions import NoSuchElementException 


# WHH EHR 

logging. basicConfig( 
# 日 志 级 别 
level = logging. INFO, 
# HERR 
# 时间 、 代 码 所 在 文件 各、 代码 行星 .日 志 级 别 和 名字、 日 志 信 息 
format = '% (asctime)s % (filename)s[line: $ (lineno)d] % (levelname)s $ (message)s', 
# 打印 日 志 的 时 间 
datefnt = '$a, $Y- %m- %d %H: %M: %S', 
# 日 志文 件 存 放 的 目录 (目录 必须 存在 ) 及 日 志文 件 各 
filename = 'd:/DataDrivenTesting/report.log', 
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# 打开 日 志文 件 的 方式 


filemode = 'w' 


(à ddt. ddt 
class TestDemo(unittest. TestCase): 
def setUp(self): 
self.driver = webdriver.Firefox(executable path- "c: V geckodriver" ) 


(Gddt.file data("test data list. json") 
def test dataPickerByRightKey(self, value): 
url = "http://www. baidu. com" 
# 访问 百度 首页 
self.driver.get(url) 
print value 
# 将 从 . json XIF P EH ih B HIE" | | HET A Ka a 0 CRI 
# 和 和 期望 数据 
testdata, expectdata = tuple(value. strip().split("||")) 
OBERE 10 f 
self.driver. implicitly wait(10) 
try: 
# RE Sedi A ie, JE i A Witt 
self.driver.find element by id("kw").send keys(testdata) 
# URBIS HE HL, JE d 
self.driver.find element by id("su").click() 
time. sleep(3) 
# METH B RJE A HIE TE DE i (CP 
self.assertTrue(expectdata in self.driver.page source) 
except NoSuchElementException, e: 
logging. error(u" 查 找 的 页 面 元 素 不 存在 , 异常 堆栈 信息 : ” 
+ str(traceback.format exc())) 
except AssertionError, e: 
logging. info(u" 搜索" % s", 期望“% s”, 失败”s% (testdata, expectdata)) 
except Exception, e: 
logging. error(u" 未 知 错误 ,错误 信息 : ”+ str(traceback.format exc())) 
else: 
logging. info(u" 搜 索 " % s", 期 望 "% s"i jd" * (testdata, expectdata)) 


def tearDown( self) : 
self.driver.quit() 

if name  --' — M 

# unittest.main() 

suitel = unittest. TestLoader(). loadTestsFromTestCase(tTestDemo) 

suite - unittest.TestSuite(suitel) 

filename = "d: WW test. html" 

fp = file(filename, 'wb') 

runner = HTMLTestRunner.HTMLTestRunner(stream = fp, title = 'Report title', description 
7 'Report description') 

runner.run(suite) # 运行 测试 集合 
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执行 结束 后 打印 的 日 志文 件 内 容 : 

Wed, 2016-12-07 10:07:51 dataDriver.py[line:53] INFO 搜索 "邓肯 " ,期望 " 蒂 姆 "通过 
Wed, 2016-12-07 10:08:06 dataDriver.py[line:53] INFO 搜索 "乔丹 ", 期 望 "迈克 尔 " 通 过 
Wed, 2016-12-07 10:08:20 dataDriver. py[1ine:53] INFO 搜索 " 库 里 ", 期 望 "斯 蒂 芬 "通过 
Wed, 2016-12-07 10:08:34 dataDriver. py[1ine:53] INFO 搜索 " 杜 兰 特 ", 期 望 " 凯 文 "通过 
Wed, 2016-12-07 10:08:48 dataDriver.py[line:53] INFO 搜索 "詹姆斯 ", 期望" 勒 布朗 "通过 


代码 解释 : 

在 测试 方法 test_dataDrivenByFile 上 使 用 @ddt. file_data() 装 饰 该 测试 方法 ,目的 是 为 
测试 方法 提供 存放 在 文件 test data. list. json 里 的 测试 数据 ,文件 里 的 数据 通过 列表 包 齐 ， 
而 列表 中 每 一 个 元 素 代 表 一 组 测试 数据 ,比如 “邓肯 | | 带 姆 "属于 第 一 组 测试 数据 ,也 就 是 程 
序 第 一 次 调用 test_dataDrivenByFile 测试 方法 时 传 入 的 数据 。 测 试 脚本 依次 从 test_data_ 
list. json 文件 中 的 列表 中 取出 需要 测试 的 数据 ,测试 结束 后 并 使 用 HTMLTestRunner fi 
块 提供 的 HTML 报告 模板 生成 测试 报告 。 





12.5 使 用 Excel 进行 数据 驱动 测试 





测试 逻辑 : 

(1) 打开 百度 首页 ,从 Excel 文件 中 读 取 测试 数据 作为 搜索 关键 词 。 

(2) 在 搜索 输入 框 中 输入 读 取出 的 搜索 关键 词 。 

(3) 单 击 搜索 按钮 。 

(4) 断言 搜索 结果 页 面 中 是 否 出 现 Excel 文件 中 提供 的 预期 内 容 , 包 含 则 认为 测试 执 
行 成 功 , 否 则 认为 失败 。 

环境 准备 : 

CD f WIN + R 组 合 键 ,在 调 出 的 运行 窗口 输入 框 中 输入 *CMD” 并 按 Enter 键 ,以 便 
调 出 Windows 的 CMD 窗口 。 

(2) 在 弹出 的 CMD 窗口 中 输入 “pip install openpyxl —— 2. 3. 3”, 进 行 安 装 Python ff 
析 Excel 2007 及 以 上 版 本 的 模块 。 

(3) 如 果 上 述 方法 安装 失败 ,读者 可 以 直接 访问 https://pypi. python. org/pypi/ 
openpyxl 下 载 openpyxl 源码 安装 包 , 后 续 安 装 方法 及 检验 安装 成 功 与 否 请 参看 12. 2 节 
内 容 。 


本 书 中 有 关 Excel 操作 的 实例 ,笔者 都 是 在 openpyxl(2. 3.3) 版 本 上 开发 

一 的 ,为 防止 高 版 本 openpyxl 包 API 不 兼容 低 版 本 的 API, 导 致 本 书 中 有 关 Excel 

EB: 解析 的 实例 代码 不 能 成 功 执行 ,所 以 这 里 需要 使 用 pip install openpyxl —— 2. 3. 3 
命令 指定 版 本 安装 。 


测试 数据 准备 : 
在 本 地 磁盘 D:\DataDrivenTesting 目录 中 新 建 一 个 “测试 数据 . xlsx”, 工 作 表 名 为 “ 搜 
索 数据 表 ” 的 Excel 文件 ,“ 搜 索 数据 表 ” 工 作 表 内 容 如 表 12-1 所 示 。 
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e 
R 12-1 
E 号 E 索 词 期 望 结果 
1 邓肯 蒂 姆 
2 乔丹 迈克 尔 
3 库 里 斯 蒂 芬 
实例 代码 : 


在 Pycharm 中 新 建 一 个 名 叫 ExcelDataDrivenProject 的 Python 工程 ,工程 下 新 建 两 个 


文件 ,文件 名 分 别 为 ExcelUtil. py 和 DataDriven. py. 
ExcelUtil. py 文件 用 于 编写 读 取 Excel 的 脚本 ,具体 内 容 如 下 : 


#encoding= utf - 8 
from openpyxl import load workbook 


class ParseExcel(object): 


def _ init (self, excelPath, sheetName): 
# 将 要 恋 取 的 Excel MRIH 
self.wb = load workbook(excelPath) 
# 通过 工作 表 和 名 黎 获 取 一 个 工作 表 对 象 
self. sheet = self.wb.get sheet by nane(sheetName) 
# NOR LIES T fe fe EHI IH X fT 


self.maxRowNum - self.sheet.max row 


def getDatasFromSheet(self): 

# 用 于 存放 从 工作 表 中 恋 取 出 夹 的 数据 

dataList = [] 

# By LfES PHR EMI, PEDE Ad 

for line in self.sheet. rows[1:]: 
# aW T FERE IH 8E— fT, 
# HE SEI TD EET CONS ID PCI FE TIE tmpList H, 
# 然后 再 将 存放 一 行 数据 的 列表 证 加 到 最 终 数据 列表 dataList 中 
tmpList = [] 
tmpList.append(line[1]. value) 
tmpList. append(line[2]. value) 
dataList.append(tmpList) 

E KR TER P BO PEE B E OT A UR Ie 

return dataList 


if name  -- ' main ': 
excelPath = u'D:\\DataDrivenTesting\\ 测 试 数据 .xlsx' 
SheetName = wu" 搜索 数据 表 " 
pe = ParseExcel(excelPath, sheetName) 
for i in pe. getDatasFromSheet( ) : 


print i[0], i[1] 
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DataDriven. py 文件 用 于 编写 数据 驱动 测试 脚本 代码 ,具体 内 容 如 下 : 


£ encoding - utf- 8 

from selenium import webdriver 

import unittest, time 

import logging, traceback 

import ddt 

from ExcelUtil import ParseExcel 

from selenium. common. exceptions import NoSuchElementExcept ion 


# WHER 

logging. basicConfig( 
# HEKI 
level = logging. INFO, 
# HEM 
# HFE AREXE ABTG HERIK F H B 
format = '% (asctime)s % (filename)s[line: % (lineno)d] % (levelname)s % (message)s', 
# JTA H SHE JR] 
datefmt = '%a, %Y- %m- %d $H:$M:$5', 
# 日 志文 件 存 放 的 月 录 ( 月 录 必 须 存 在 ) 及 月 起 文件 名 
filename = 'd:/DataDrivenTesting/dataDriveRreport. log', 
# 打开 日 志文 作 的 方式 


filemode - 'w' 


excelPath = u'D:WDataDrivenTesting V Vil it R. x1sx' 
SheetName = u" 搜 索 数 据 表 "” 
# 创建 ParseExcel 类 的 实例 对 象 


excel = ParseExcel(excelPath, sheetName) 


@ddt. ddt 
class TestDemo(unittest. TestCase) : 


def setUp(self): 
self.driver = webdriver.Firefox(executable path = "c: WV geckodriver" ) 


(à ddt. data( * excel. getDatasFronSheet()) 
def test dataDrivenByFile(self, data): 
testData, expectData = tuple(data) 
url = "http://www.baidu. com" 
# llt E e n 
self.driver.get(url) 
5 HEUTE IEEE O REKI 
self.driver.maximize window() 
print testData, expectData 
E BARGE EA 10 Eh 
self. driver. implicitly wait(10) 


try: 
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* ERIS Sedi A HE, 并 答 人 测试 数据 

self.driver.find element by id("kw").send keys(testData) 

# HIS E, Ed: 

self.driver.find element by id("su").click() 

time. sleep(3) 

# BFT R ii RAe A ih BETE CUR (C P 

self.assertTrue(expectData in self.driver.page source) 
except NoSuchElementException, e: 

logging. error(u" 查 找 的 页 面 元 素 不 存在 , 异常 堆栈 信息 : ” 

+ str(traceback. format exc())) 

except AssertionError, e: 

logging. info(u" 搜 索 " % s", Hj EB" t s", 失败"”% (testData, expectData)) 
except Exception, e: 

logging. error(u" 未 知 错误 ,错误 信息 : " + str(traceback. format exc())) 
else: 

logging. info(u" 搜 索 "% s", 期望 "% s" 通 过 " % (testData, expectData)) 


def tearDown(self): 
self.driver.quit() 


if nane E main $ 


unittest. main( ) 


执行 结束 后 日 志文 件 内容 如 下 : 





Thu, 2016-12-08 11:03:27 dataDriver.py[line:67] INFO 搜索 " 库 里 ", 期 望 " 斯 蒂 芬 "通过 


代码 解释 : 

(& ddt. data 从 excel. getDatasFromSheet() 方 法 中 接收 一 个 可 和 迭代 的 数组 对 象 ,以 此 来 
判断 需要 执行 的 次 数 。 如 果 @ddt. data ) 括 号 中 传 的 是 一 个 方法 ,方法 前 需要 加 星 号 (* ) 
修饰 。 


12.6 WEISE EE rop 





测试 逻辑 : 

(1) 打开 百度 首页 ,从 XML 文件 中 读 取 测试 数据 作为 搜索 关键 词 。 

(2) 在 搜索 输入 框 中 输入 读 取 出 的 搜索 关键 词 。 

(3) 单 击 搜索 按钮 。 

(4) 断言 搜索 结果 页 面 中 是 否 出 现 XML 文件 中 提供 的 预期 内 容 ,包含 则 认为 测试 执行 
成 功 ,否则 认为 失败 。 

实例 代码: 

在 PyCharm 中 新 建 一 个 名 叫 XMLDataDrivenProject 的 Python 工程 ,并 在 工程 下 新 建 
三 个 文件 ,文件 名 分 别 为 XmlUtil. py, TestData. xml 以 及 DataDrivenByXML. py. 

TestData. xml 文件 用 于 存放 测试 数据 ,具体 内 容 如 下 : 
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< xml version ="1.0" encoding = "utf - 8"? > 
< bookList type = "technology"» 
< book» 
<name> Selenium WebDriver 实战 宝典 </name > 
< author > 吴 晓 华 </author > 
</book> 
<book> 
« nane » HTTP 权威 指南 </name> 
< author » j^; /K f| «/author > 
«/book» 
< book» 
< name > 探索 式 软件 测试 </name> 
< author > 惠 特 克 </author > 
</book> 
</bookList > 


XmlUtil. py 文件 用 于 解析 XML 文件 ,获取 测试 数据 ,具体 内 容 如 下 : 


#encoding= utf -8 
from xml.etree import ElementTree 


class ParseXML(object) : 
def _ init (self, xmlPath): 
self.xmlPath = xmlPath 


def getRoot(self): 
# 困 开 将要 解析 的 XML X fF 
tree = ElementTree. parse(self.xmlPath) 
# 获取 XML 文件 的 根 芳 点 对 象 ,也 就 是 桂 的 根 
# 然后 返回 纷 调用 者 


return tree. getroot() 


def findNodeByName(self, parentNode, nodeName) : 


Soup eT, dU eo e 
nodes = parentNode. findall(nodeName) 


return nodes 


def getNodeOfChildText(self, node): 
# 获取 节点 node FA TO T e A TES key, 


8X fEX value ARHI FHI R 
childrenTextDict = (i.tag: i.text for i in list(node. iter())[1:]) 


# 上 面 代 码 等 价 于 下 面 代码 


childrenTextDict = () 
for i in list(node. iter())[1:]: 
childrenTextDict[i.tag] - i.text 


return childrenTextDict 


def getDataFromXml(self): 
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# GER XML X PRATO RUM E 
root - self.getRoot() 
* KRRB A FA ATH book Hy H ex X1 
books = self.findNodeByName(root, "book" ) 
dataList = [] 
# 遍历 获取 到 的 所 有 book 节点 对 条 , 
# 有 取得 需要 的 测试 数据 
for book in books: 
childrenText = self.getNodeOfChildText(book) 
dataList.append(childrenText) 
return dataList 
if name  -- ' main ': 
xml = ParseXML(r"D:VPythonProjectV Calc VTestData. xml" ) 
datas = xml.getDataFromXml() 
for i in datas: 
print i["name"], i["author"] 


DataDrivenByXML. py 文件 用 于 编写 数据 驱动 测试 脚本 ,具体 内 容 如 下 : 


# encoding= utf- 8 

from selenium import webdriver 

import unittest, time, os 

import logging, traceback 

import ddt 

from XnlUtil import ParseXML 

from selenium. common, exceptions import NoSuchElementException 


# WHER 
logging. basicConfig( 
# 日 志 级 别 
level = logging. INFO, 
# 日 志 格 式 
# 时间 、 伐 码 所 在 文件 各、 代码 行 旦 ,日 志 级 别 和 名字、 日 志 信 息 
format = '% (asctime)s % (filename)s[line: % (lineno)d] $ (levelname)s % (message)s', 
# 打印 日 志 的 时 间 
datefmt = '%a, %Y- %m- $d $H: $M: $S', 
# HEX KH HR (HRUDE) R HEX 
filename = 'd:/DataDrivenTesting/dataDriveRreport. log', 
# 打开 日 志文 伯 的 方式 
filemode = 'w' 
) 
# KRANKEN ER ER MU AB ERE GG 
currentPath = os.path.dirname(os.path.abspath( file )) 
# HIRES FID 46 XE BEES 
dataFilePath = os.path. join(currentPath, "TestData. xml") 
print dataFilePath 


# 创建 ParseXML 2E S fr] x] 4e 
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xml - ParseXML(dataFilePath) 


(à ddt. ddt 
class TestDemo(unittest. TestCase): 


def setUp(self): 
self.driver = webdriver.Firefox(executable path- "c: M geckodriver" ) 


(à ddt. data( x xml. getDataFromXnl()) 
def test dataDrivenByXML(self, data): 
testData, expectData = data["name"], data["author"] 
url = "http://www.baidu. com" 
# 访问 百度 首页 
self.driver.get(url) 
# HEDI M Aie BT UL BK TE 
self.driver.maximize window() 
print testData, expectData 
# BERIETE 10 E 


self.driver. implicitly wait(10) 


try: 

# RERAMA fie, JE i A EBORE: 

self.driver.find element by id("kw").send keys(testData) 

# REIS See, JEn id; 

self.driver.find element by id("su").click() 

tine. sleep(3) 

# ONERE BAUR A th BE T VIR FCIRE 

self.assertTrue(expectData in self.driver.page source) 
except NoSuchElementException, e: 

logging. error(u" 查 找 的 页 面 元 素 不 存在 , 异常 堆栈 信息 : ” 

+ str(traceback. format exc())) 

except AssertionError, e: 

logging. info(u" 搜 索 "% s", 期望"% s" ,失败 ”$ (testData, expectData)) 
except Exception, e: 

logging. error(u" 未 知 错误 ,错误 信息 : ”+ str(traceback.format exc())) 
else: 

logging. info(u 搜 索 " $ s", 期望"% s" 通 过 ”$ (testData, expectData)) 


def tearDown(self): 
self.driver.quit() 


' main  "': 


if name  --' — 
unittest.main() 


执行 结束 后 日 志文 件 内 容 如 下 : 


Thu, 2016-12-08 14:52:17 DataDrivenByXML. py[ 1ine:64] INFO 搜索 "Selenium WebDriver 实战 宝典 "， 
Thu, 2016-12-08 14:52:32 DataDrivenByXML. py[ 1ine:64] INFO 搜索 "HTTP 权威 指南 ", 期 望 " 古 尔 利 " 
通过 

Thu, 2016-12-08 14:52:47 DataDrivenByXML. py[ line: 64] INFO 搜索 "探索 式 软件 测试 ,期 望 " 惠 特 
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12.7 WESCE E JESUS EP EU 





测试 逻辑 : 

CD 打开 百度 首页 ,从 MySQL 数据 库 中 获取 测试 过 程 中 需要 的 测试 数据 。 

(2) 在 搜索 输入 框 中 输入 查询 关键 词 测试 数据 。 

CD 单 击 搜索 按钮 。 

(4) 断言 搜索 结果 页 面 中 是 否 出 现 数据 库 中 提供 的 预期 内 容 , 包 含 则 认为 测试 执行 成 
功 ,否则 认为 失败 。 

环境 准备 : 

(1) 从 http://dev. mysql. com/downloads/mysql/5. 5. html € downloads 下 载 MySQL 
5.5 安装 文件 (扩展 名 为 . msi 的 文件 ) ,请 读者 根据 自己 操作 系统 位 数 选择 相应 的 安装 文件 
进行 下 载 。 

(2) 在 安装 MySQL 5. 5 的 过 程 中 ,请 读者 设置 好 登录 数据 库 的 用 户 名 root 的 密码 并 
记 住 ,如 图 12-4 所 示 , 并 将 数据 库 默 认 字符 集 修改 成 utf8, 如 图 12-5 所 示 。 


MySQU Server Instance Configuration 
Configure the MYSQL Server $5 server instance. 








Please set the security options. 
[7 Modify Security Settings — 
: Contr: A ad .. Retype the password. 


MeV. Enable root access from remote machine 


设置 root 用 户 登 录 的 密码 


account on this server. 
Please note that this can lead to an insecure system. 





"ET AUT 
图 12-4 
MySQL Server Instance Configuration W 
| MySQL Server Instance Configuration 


Configure the MYSQL Server 55 server instance 





Please select the default character set. 


后 Standard Character Set 
Makes Latinl the defaut charset. This character set is suited for 
English and other West European languages- 


| Ctr m 
Make UTFS the defaut character set. This is the recommended 
character set for stoning text in many dáferent languages 


|| C mamuat Selected Default character set 1 cotation 选择 utf8 编 码 











<Back Cancel 
E 
图 12-5 
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(3) f Ctrl 十 R 组 合 键 调 出 运行 窗口 ,在 打开 输入 框 中 输入 "SERVICES. msc" 并 回 车 ， 
打开 计算 机 服务 管理 界面 ,在 该 界面 找到 MySQL 服务 并 启动 ,如 果 在 安装 过 程 中 选择 了 启 
动 MySQL 服务 选项 ,这 一 步 可 以 略 过 。 

(OD. “FR” —" Br ETE" — MySQL MySQL Server 5. 5— MySQL 
Line Client, 启 动 MySQL 数据 库 ,在 弹出 的 命令 窗口 输入 MySQL 登录 密码 进行 登录 ,然后 
出 现 如 图 12-6 所 示 界 面 ,表示 MySQL 数据 库 : 





Command 








E MySQL 5.5 Command Line Client 
password? HA d SANE MySQL E 
come to the M: monitor. C á 
onnection id is 19 
. 5. 50 MySQL Community Server (GPL) 


Copyright (c) 2000, 2016, Oracle and/or its affiliates. All rights reserved. 
a registered trademark of Oracle Corporation and/or its 


s. Other names may be trademarks of their respective 


'help; or 'W' for help. Type 'Nc' to clear the current input statement. 





图 12-6 


(5) 访问 http://www. codegood. com/downloads ,根据 系统 类 型 .安装 "y Python 版 本 
及 Python 位 数 下 载 相 对 应 的 Python 连接 MySQL 数据 库 的 连接 器 安装 文件 (比如 
MySQI-python-1. 2. 3. win32-py2. 7. exe) ,下载 到 本 地 后 直接 安装 即 可 

(6) 安装 完成 后 ,进入 Python 交互 模式 ,执行 import MySQLdb, 未 报错 说 明 已 经 安装 
成 功 。 

实例 代码 : 

er PyCharm 工具 中 新 建 一 个 名 为 DataBaseDataDrivenProject 的 Python 工程 ,并 
在 该 工程 下 新 建 4 个 文件 ,文件 名 分 别 为 Sql. py, Databaselnit. py, MysqlUtil. py 和 
DataDrivenByMySQL. py 

Sql. py 文件 用 于 编写 创建 数据 库 及 数据 表 的 SQL 语句 ,具体 内 容 如 下 : 












# encoding = utf - 8 


# 创建 gloryroad 数据 库 SQL 语句 
create database = 'CREATE DATABASE IF NOT EXISTS gloryroad DEFAULT CHARSET utf8 COLLATE utf8 - 


general ci;' 


# 创建 testdata X 
create table - """ 
drop table if exists testdata; 
create table testdata( 
id int not null auto increment comment ' 主 键 '， 
bookname varchar(40) unique not null comment ' 书 名 ', 


author varchar(30) not null comment ' 作 者 '， 
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primary key(id) 
)engine = innodb character set utf8 comment ' 测 试 数 据 表 '; 


Databaselnit. py 文件 用 于 编写 初始 化 数据 库 的 脚本 ,具体 内 容 如 下 : 


# encoding = utf -8 
import MYSOLdb 
from Sql import * 


class DataBaseInit (object) : 
# RRM TW, AdE tR NE 
# 创建 数据 库 , 创建 数据 表 , 向 表 中 插 人 测试 数据 


def _ init (self, host, port, dbName, username, password, charset): 
self.host - host 
self.port - port 
self.db = dbName 
self.user = usernane 
self. passwd = password 
self. charset = charset 


def create(self): 
try: 
# GEH MySOL 数据 库 
conn = MySQLdb. connect( 
host = self.host, 
port = self.port, 
user - self.user, 
passwd = self.passwd, 
charset - self.charset 
) 
# 获取 数据 库 游标 
cur = conn.cursor() 
# 创建 数据 库 
cur. execute(create_database) 
# 选择 创建 好 的 gloryroad 数据 库 
conn. select_db("gloryroad" ) 
# 创建 测试 表 
cur.execute(create table) 
except MySQLdb. Error, e: 
raise e 
else: 
# 关闭 游标 
cur. close() 
# 提交 操作 
conn. commit() 
# XHHEE 
conn. close() 


print u" 创 建 数据 库 及 表 成 功 ” 


def insertDatas(self): 
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try: 
* IEF MySOL E REPE 
conn = MySQLdb. connect( 
host = self.host, 
port = self.port, 
db = self.db, 
user - self.user, 
passwd - self.passwd, 
charset - self.charset 
) 
cur - conn.cursor() 
# 向 测试 表 中 括 人 测试 数据 
Sql = "insert into testdata(bookname, author) values( % s, %s);" 
res = cur.executemany(sql, [('Selenium WebDriver 实战 宝典 '，' 吴 晓 华 ')， 
('HTTP 权威 指南 '，' 古 尔 利 ')， 
( "探索 式 软件 测试 '，' 惠 特 克 ' )， 
(' 暗 时 间 '，' 刘 未 鹏 ') ]) 
except MySQLdb. Error, e: 
raise e 
else: 
conn. comnit() 
print 初始 数据 插入 成 功 " 
# 确认 插 人 数据 成 功 
cur.execute("select * from testdata;") 
for i in cur.fetchall(): 
print i[1], i[2] 
cur. close() 
conn. close() 


if name  -- ' main ': 

db = DataBaselnit( 
host = "localhost", 
port - 3306, 
dbName = " gloryroad", 
username = "root", 
password -"root", 
charset = "utf8" 

) 

db.create() 

db. insertDatas() 

print u" 数 据 库 初始 化 结束 " 


MysqlUtil. py 文件 用 于 从 数据 库 中 获取 测试 数据 ,具体 内 容 如 下 : 


#encoding= utf - 8 
import MySQLdb 
from DatabaselInit import DataBaselnit 


class MyMySQL(object): 
def ^ init (self, host, port, dbName, username, password, charset): 
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# EITBR AE 


dbInit = DataBaseInit(host, port, dbName, username, password, charset) 
dbInit.create() 

dbInit. insertDatas() 

self.conn = MySQLdb. connect( 


host - host, 
port - port, 
db - dbName, 


user - username, 

passwd - password, 

charset - charset 
) 


self.cur - self.conn.cursor() 


def getDataFromDataBases(self): 
# M testdata 表 中 获取 需要 的 测试 数据 
# bookname ff Jj 18 R K ftl is], author ff: Jy WY X fei 
self. cur. execute(" select bookname, author from testdata;") 
# MERI X AR H pl Pr E TR 
datasTuple - self.cur.fetchall() 
return datasTuple 


def closeDatabase(self): 
# 数据 库 后 期 清理 工作 
self.cur.close() 
self. conn. connit() 
self. conn. close() 


if name _ == '_ 
db = MyMySQL( 
host = "localhost", 
port = 3306, 
dbName = "gloryroad", 


username = "root", 


main 


password = "root", 

charset - "utf8" 
) 
print db. getDataFromDataBases() 
db. closeDatabase() 


DataDrivenBy MySQL. py 文件 用 于 编写 执行 数据 驱动 测试 脚本 ,具体 内 容 如 下 : 


£ encoding- utf 一 8 

from selenium import webdriver 

import unittest, time 

import logging, traceback 

import ddt 

from MysqlUtil import MyMySQL 

from selenium. common. exceptions import NoSuchElementException 


# NAMEHGXS 
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logging. basicConfig( 
# HERH 
level = logging. INFO, 
# HERR 
# BEE ARNEE ABTG HERI F H E B 
format = '% (asctime)s % (filename)s[line: $ (lineno)d] % (levelname)s % (message)s', 
# 打印 日 志 的 时 间 
datefmt = '%a, %Y- %m- %d $H:$M:$5S', 
# 日 志文 作 存 放 的 有 目录 (目录 必须 疗 在 ) 及 日 志文 作 和 名 
filename = 'd:/DataDrivenTesting/dataDriveRreport. log', 
# 打开 日 志文 件 的 方式 
filemode = 'w' 


) 


def getTestDatas(): 
db = MyMySQL( 
host - "localhost", 
port = 3306, 
dbName = "gloryroad", 
username = "root", 
password - "root", 
charset - "utf8" 
) 
# 从 数据 库 测试 表 中 获取 测试 数据 
testData = db. getDataFromDataBases( ) 
# KARHE E 
db. closeDatabase() 
return testData 


@ddt. ddt 
class TestDemo(unittest. TestCase) : 


def setUp(self): 
self.driver = webdriver.Firefox(executable path="c:\\geckodriver") 


(à ddt. data( * getTestDatas()) 
def test dataDrivenByDatabase(self, data): 
# 对 获得 的 数据 进行 解 包 
testData, expectData = data 
url = "http://www. baidu. com" 
# 访问 百度 首页 
self.driver.get(url) 
ERN AE BI UL AC TE 
self.driver.maximize window() 
print testData, expectData 
# BEBIESGCEAMIBA 10£ 
self.driver. inplicitly wait(10) 
try: 
# RIRR MAE, 并 输 人 测试 数据 
self. driver. find element by id("kw").send keys(testData) 
# SI SHE, JE ds 
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self. driver. find element by id("su").click() 

time. sleep(3) 

# 肠 言 期望 辕 扣 是 否 出 现在 页 面 源 代码 中 

self. assertTrue( expectData in self. driver. page_source) 
except NoSuchElementException, e: 

logging. error(u" 查 找 的 页 面 元 素 不 存在 ,异常 堆栈 信息 :"\ 

+ str(traceback. format exc())) 

except AssertionError, e: 

logging. info(u" 搜 索 "% s", 期望 ”"% s", X WI" * (testData, expectData)) 
except Exception, e: 

logging. error(u" 未知 错误 ,错误 信息 : ”+ str(traceback.format exc())) 
else: 

logging. info(u" 18 R" * s", 期望"% s" 通 过 " % (testData, expectData)) 


def tearDown(self): 
self.driver.quit() 


if name  -- ' main ': 


unittest. main() 
执行 结束 后 打印 的 日 志文 件 内 容 如 下 : 


Fri, 2016-12-09 14:38:15 DataDrivenByMySQL. py[ line:70] INFO 搜索 "Selenium WebDriver 实战 宝 
典 ", 期 望 " 吴 晓 华 "通过 

Fri, 2016-12-09 14:38:28 DataDrivenByMySQL. py[ line: 70] INFO 搜索 "HTTP 权威 指南 ", 期 望 " 古 尔 
利 "通过 

Fri, 2016-12-09 14:38:42 DataDrivenByMySQL. py[ line:70] INFO 搜索 "探索 式 软件 测试 ", 期望 " 惠 特 
Fri, 2016-12-09 14:38:55 DataDrivenByMySQL. py[1ine:70] INFO 搜索 " 暗 时 间 ", 期 望 " 刘 未 鹏 "通过 


s 13s 行为 驱动 测试 


行为 驱动 测试 方法 已 经 在 敏捷 开发 模式 中 普遍 使 用 ,通过 使 用 标准 化 的 语言 将 客户 需 
求人 员 、 开 发 人 员 和 测试 人 员 关 联 在 一 起 ,让 产品 开发 相关 人 员 在 沟通 上 保持 一 致 。 请 参与 
敏捷 开发 项 目的 读者 仔细 阅读 本 章 内 容 , 充 分 理解 行为 驱动 测试 原则 机制 和 实践 方法 。 


13.1 Wee eue E 





行为 驱动 开发 是 一 种 敏捷 软件 开发 技术 , 它 的 英文 全 称 是 Behavior Driven 
Development ,英文 缩写 为 BDD。BDD 最 初 由 Dan North 在 2003 年 命名 , 它 包 括 验 收 测试 
和 客户 测试 驱动 等 极限 编程 实践 ,作为 对 测试 驱动 开发 的 回应 。 它 鼓励 软件 项 目 中 的 开发 
者 .QA, 非 技术 人 员 或 商业 参与 者 之 间 进 行 协作 。 在 过 去 数 年 里 ,BDD 开发 模式 得 到 了 很 
大 的 发 展 ,BDD 的 流行 已 然 无 法 逆转 。 

lettuce 是 实现 BDD 开发 模式 的 一 种 测试 框架 ,实现 了 使 用 自然 语言 来 执行 相关 联 测 
试 的 代码 的 需求 。lettuce 是 基于 Cucumber 的 一 款 非 常 易 于 使 用 的 BDD 工具 ,可 以 执行 纯 
文本 的 功能 描述 。lettuce 使 用 Gherkin 语言 来 描述 测试 功能 测试 场景 .测试 步骤 和 测试 
结果 ,Gherkin 语言 支持 超过 40 种 自然 语言 ,包括 英文 和 中 文 。Gherkin 语言 使 用 的 主要 英 
文 关 键 词 有 Scenario, Given, When, And, Then 和 But 等 ,这 些 关键 词 也 可 以 转换 为 中 文 关 
键 词 ,例如 “场景 如果“ 当 ”那么 ”。 根 据 用 户 故 事 , 需 求人 员 或 测试 人 员 使 用 Gherkin if 
言 编写 好 测试 场景 的 每 个 执行 步骤 ,lettuce 就 会 一 步 一 步 地 解析 关键 词 右 侧 的 自然 语言 
执行 相应 的 代码 。 

关键 词 的 含义 如 下 : 

(1) Feature: 特性 ,将 多 个 测试 用 例 集合 到 一 起 ,对 应 于 unittest 中 的 test suite( 测 试 
用 例 集 )。 

(2) Scenario; 情景 ,用 于 描述 一 个 用 例 , 对 应 于 unittest 中 的 test case( 测 试用 例 )。 

(3) Given; 如 果 , 用 例 开 始 执行 前 的 一 个 前 置 条 件 ,类似 于 unittest 中 setup 方法 中 的 
一 些 步 又。 

(4) When: 当 , 用 例 开始 执行 时 的 一 些 关 键 操作 步骤 ,类 似 于 unittest 中 的 以 test 开头 
的 方法 ,比如 执行 一 个 单 击 元 素 的 操作 。 

(5) Then: 那么 ,验证 结果 ,就 是 平时 用 例 中 的 验证 步骤 ,比如 assert 方法 。 

(6) And; 和 ,一 个 步骤 中 如 果 存在 多 个 Given 操作 ,后 面 的 Given 可 以 用 And 替代 。 

CT) But; 一 个 步骤 中 如 果 存 在 多 个 Then 操作 ,第 二 个 开始 后 面 的 Then 可 以 用 But 替代 。 

使 用 Gherkin 语言 编写 测试 场景 的 执行 步骤 ,并 将 执行 步骤 保存 在 扩展 名 为 feature 的 
文件 中 ,每 个 . feature 文件 都 要 开始 于 Feature( 功 能 ) 关 键 词 ,Feature 之 后 的 描述 可 以 自 定 
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义 , 直 到 出 现 Scenario (场景 ) 关 键 词 。 一 个 . feature 文件 中 可 以 有 多 个 Scenario. 每 个 
Scenario 包含 步骤 (step) 列 表 , 不 同步 骤 使 用 Given, When, Then, But, And 这 些 关 键 词 进 
行 区 分 。 

BDD 开发 模式 的 好 处 在 于 ,可 以 将 用 户 故事 (敏捷 开发 中 的 User Story) 或 者 需求 和 测 
试用 例 建 立 起 对 应 的 映射 关系 ,保证 开发 和 测试 的 目标 与 范围 严格 地 和 需求 保持 一 致 , 
可 以 更 好 地 让 需求 方 、 开 发 者 以 及 测试 人 员 用 唯一 的 需求 进行 相关 开发 工作 ,防止 对 需求 理 
解 的 不 一 致 ,并 且 BDD 框架 的 测试 结果 很 容易 被 参与 者 所 理解 。 

lettuce 的 工作 流程 如 图 13-1 所 示 。 

















tol 
Emm = 


Emm 


run and define steps 
Watch it pass in python 


write code to run and 
make it pass [c] woatch it fail 





图 13-1 


13.2 p; E tops do ELS 3 





CD 在 “开始 ”>“ 搜 索 程序 和 文件 " 框 中 输入 *CMD” 并 回 车 ,然后 在 打开 的 CMD 窗口 
中 输入 “pip install lettuce” 并 回 车 ,进行 lettuce 模块 的 安装 。 

(2) 等 安装 进度 条 走 完 . 在 CMD 下 输入 “python” 进 入 python 交互 模式 ,执行 “import 
lettuce" ,如 果 未 报错 ,说 明 lettuce 模块 已 安装 成 功 。 

使 用 pip 不 能 成 功 安装 的 读者 ,可 以 直接 访问 https://pypi. python. org/pypi/lettuce/ 
0.2.23 下 载 lettuce 的 源码 包 进 行 安装 ,如 图 13-2 所 示 , 源码 安装 方法 请 参看 第 6 章 
selenium 3 的 安装 方法 。 


You should have received a copy of the GNU General Public License 
along with this program If not, see «http: www gnu org= licenses=™/> 

















[ Type Py Version. Uploaded on 
Tettuce-0 223 tar gz (md5) >e V Source 2016-07-26 
Ep 单 击 下 载 
图 13-2 
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13.3 nO Sa 





测试 逻辑 
(1) 从 lettuce 全 局 变量 命名 空间 world 中 取得 一 个 整数 。 
(2) 计算 该 整数 的 阶乘 。 
(3) 断言 计算 结果 的 正确 性 。 
BDD 实施 步骤 : 
(1) 在 PyCharm 工具 创建 如 下 所 示 的 目录 结构 及 文件 。 
|lettuce 

| MyFirstBDD 

| features 


- zero. feature 


— steps. py 


前 两 层 目录 lettuce 和 MyFirst BDD 不 是 必需 的 ,而 且 名 字 可 以 自 定义 ; 但 features H 
录 是 必须 存在 的 ,并 且 目 录 名 不 能 更 改 ,执行 行为 驱动 脚本 时 ,lettuce 首先 寻找 的 就 是 具有 
这 个 名 字 的 目录 ; features 目录 下 存放 的 是 执行 场景 文件 (扩展 名 为 . feature 的 文件 ) 和 描 
述 行为 的 脚本 文件 (扩展 名 为 . py 的 文件 ) ,创建 好 的 目录 结构 如 图 13-3 所 示 。 


(2) zero. feature 用 于 完成 lettuce 工作 流程 的 第 一 步 , 描 Enna j E ere) 


述 测试 场景 的 行为 ,具体 内 容 如 下 : Proa -|O deg 
* D EnglishAndClass D:\Python 


» D features 


Feature:Compute factorial 
In order to play with Lettuce 
As beginners X M TT 


We'll implement factorial v D features 
È steps.py 
zero feature 


Scenario: Factorial of 0 
Given I have the number 0 图 13-3 





When I conpute its factorial 
Then I see the nunber 1 


Scenario: Factorial of 1 
Given I have the number 1 
When I compute its factorial 
Then I see the number 1 


Scenario: Factorial of 2 
Given I have the nunber 2 
When I conpute its factorial 
Then I see the nunber 2 


Scenario: Factorial of 3 
Given I have the number 3 
When I compute its factorial 
Then I see the nunber 6 
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如 果 . feature 文件 想 直 接 通过 记事 本 等 文本 编辑 器 进行 创建 ,必须 将 该 文 
件 保 存 为 utf-8 编码 。 





(3) steps. py 里 面 使 用 Python 语言 编写 行为 步骤 ,并 且 提供 检测 执行 结果 代码 ,具体 
内 容 如 下 : 


# encoding = utf -8 
from lettuce import * 


# MF EHA Bh NR m 
def factorial(number) : 
number = int(number) 
if (number == 0) or (number == 1): 
return 1 
else: 
return reduce( lambda x, y: x * y, range(1, number + 1)) 





@step('I have the number (\d+ )') 
def have_the_number(step, number) : 
# H ERAREMA FE FEE world 中 


world. number = int(number) 


@step('I compute its factorial') 

def compute its factorial(step): 
# 从 全 局 变量 world rJ di Io BOR, 
EO, JEETATR BETE world 中 
world.number - factorial(world. number) 


(àstep('I see the number (Md * )') 
def check number(step, expected): 
# 通过 正则 匹配 到 预期 数字 
expected = int(expected) 
# 肠 言 计算 阶乘 结果 是 否 等 于 瑚 期 
assert world. number == expected, "Got %d" % world. number 


(4) 在 PyCharm 工具 的 Terminal( 终 端 ) 中 ,将 当前 工作 目录 切换 到 features 目录 所 在 
目录 (操作 方法 同 Windows 的 CMD) ,然后 执行 命令 "lettuce” 启 动 行为 驱动 测试 ,如 图 13-4 
所 示 。 


切换 当前 工作 目录 到 features 目 录 所 在 目录 中 
D: \pythonproject \EnglishAndc1 aed D: \PythonProject Engl ishAndClass et tuce \yFirstBDD 


D: VythonProject Engl ishhndClass lettuce WgFirstBDlfettuce]] ) 执行 lettuce 命 令 
&TODO $ Python Console 


Meer. and Dhanin dee Dia ha nre eet Cet ie enad de farris NAN 








13-4 


TA : 
执行 结束 后 ,会 在 Terminal 中 打印 结果 信息 ,如 下 : 
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Feature: Compute factorial # \features\zero. feature:1 
In order to play with Lettuce # \features\zero. feature:2 
As beginners # \features\zero. feature:3 
We'll implement factorial # \features\zero. feature:4 
Scenario: Factorial of 0 # \features\zero. feature: 6 

Given I have the number 0 # \features\steps. py:13 
When I compute its factorial # \features\steps. py:17 
Then I see the number 1 # \features\steps. py:21 
Scenario: Factorial of 1 # \features\zero. feature:11 
Given I have the number 1 # \features\steps. py:13 
When I compute its factorial # \features\steps. py:17 
Then I see the number 1 # \features\steps. py:21 
Scenario: Factorial of 2 # \features\zero. feature:16 


Given I have the number 2 
When I compute its factorial 


# \features\steps. py:13 
# \features\steps. py:17 


Then I see the number 2 # \features\steps. py:21 

Scenario: Factorial of 3 
Given I have the number 3 
When I compute its factorial 
Then I see the number 6 


# \features\zero. feature:21 
# \features\steps. py:13 
# \features\steps. py:17 
# \features\steps. py:21 


1 feature (1 passed) 

4 scenarios (4 passed) 

12 steps (12 passed) 

代码 解释 : 

执行 结果 中 1 feature (1 passed) 表 示 有 一 个 features 被 执行 通过 了 。4 scenarios 
(4 passed) 表 示 有 4 个 scenarios( 场 景 ,对 应 zero. feature 文件 中 的 4 个 scenarios ,每 个 场景 
均 会 被 执行 ) 被 执行 通过 了 。12 steps (12 passed) 表 示 4 个 scenarios 总 共有 12 步 , 均 被 执 
行 通过 。 

一 个 scenarios 中 有 三 步 ,分 别 为 Given, When 和 Then 标注 的 步骤 ,执行 它们 的 方法 分 
别 对 应 steps. py 文件 中 的 @step('I have the number (\d+)'), @step('I compute its 
factorial') 和 @step('I see the number (\d 十 )'") 修 饰 的 方法 ,其 中 (\d 十 ) 是 一 个 正则 表达 
式 ,\d 表示 匹配 一 个 数字 ,十 号 表示 匹配 的 数字 至 少 有 一 个 或 多 个 ,@step('I have the 
number (\d 十 )") 步 又 中 (\d 十 ) 数 字 来 自 zero. feature 文件 中 的 Given 后 面 步骤 描述 中 的 数 
字 , 比 如 Given I have the number 0 中 的 0, @step('I see the number (Vd) ) 步 骤 中 的 
(\d 十 ) 来 自 zero. feature 文件 中 的 Then 后 面 步 又 描述 中 的 数字 ,比如 T see the number 1 
中 的 1。 这些 数字 通过 正则 表达 式 匹 配 出 来 以 后 存储 在 lettuce 全 局 变量 命名 空间 world 
中 ,对 应 实例 代码 world. number = int( number) ,后 续 测 试 过 程 中 需要 使 用 时 直接 从 
world 中 取 即 可 。 
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更 多 说 明 : 
关于 行为 驱动 测试 的 执行 方式 除了 本 例 所 提 到 的 方式 以 外 ,还 可 以 直接 通过 CMD 进 
行 执行 。 首 先 按 下 Win + R 组 合 键 ,在 弹出 的 运行 框 中 输入 *CMD” 回 车 ,弹出 CMD 窗口 ， 
然后 将 当前 的 工作 目录 切换 到 要 执行 的 测试 用 例 集 features 目录 所 在 的 目录 中 ,最 后 执行 
lettuce 命令 即 可 ,如 图 13-5 所 示 。 





A A 


< 执行 lettuce 命 令 





测试 逻辑 : 

CD 将 测试 步骤 方法 封装 到 类 中 ,并 从 全 局 变量 中 获取 需要 的 计算 阶乘 的 整数 。 
(2) 计算 该 整数 的 阶乘 

(3) 断言 计算 结果 的 正确 性 

BDD 的 实施 步骤 : 

(1) 在 PyCharm 工具 创建 如 下 所 示 的 目录 结构 及 文件 





| lettuce 
|ClassBDD 
| features 
一 zero. feature 


一 steps.py 
(2) zero. feature 文件 具体 内 容 如 下 : 


Feature:Compute factorial 


* 266 - 


第 13 章 行为 驱动 测试 





In order to play with Lettuce 
Rs beginners 
We'll implement factorial 


Scenario: Factorial of 0 
Given I have the number 0 
When I conpute its factorial 
Then I see the number 1 


Scenario: Factorial of 1 
Given I have the number 1 
When I compute its factorial 
Then I see the number 1 


Scenario: Factorial of 2 
Given I have the number 2 
When I compute its factorial 
Then I see the number 2 


Scenario: Factorial of 3 
Given I have the number 3 
When I conpute its factorial 
Then I see the number 6 


(3) steps. py 文件 具体 内 容 如 下 : 


st encoding - utf -8 
from lettuce import world, steps 


def factorial(number): 
number = int(number) 
if (number == 0) or (number == 1): 
return 1 
else: 
return reduce(lambda x, y: x * y, range(1, number + 1)) 


(à steps 
class FactorialSteps(object): 


"""Methods in exclude or starting with will not be considered as step"" 
exclude - ['set number', 'get number'] 
def — init (self, environs): 
# NH 
self.environs - environs 
def set number(self, value): 


E BEBE A m number FRI fii 


self.environs.number - int(value) 
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def get number(self): 


# 从 全 局 变量 中 取出 number fj (f 


return self. environs. number 


def assert number is(self, expected, msg="Got % d"): 
number - self.get number() 
# HB 
assert number == expected, msg % number 


def have the number(self, step, number): 
'''I have the number (Yd * )''" 
* 上 面 的 三 3 引号 引起 的 代码 必须 写 , 并 且 必 须 是 三 引号 引起 
# 表示 从 场 始 步 紧 中 获取 需要 的 数据 
E 卉 将 获得 数据 存 到 全 局 变量 number 中 
self.set number(number) 


def i compute its factorial(self, step): 
number = self.get number() 
* 调用 factorial 方法 进行 阶乘 结算 , 
# 并 将 结算 结 扶 郑 于 全 局 变量 中 的 number 中 
self. set_number(factorial (number)) 


def check number(self, step, expected): 
'"'I see the number (Yd * )''" 
# 上 面 的 三 引号 引起 的 代码 必须 写 ,并 且 必 须 是 三 3 号 引起 
BORN MSIE TET ETUR E TRECE DL BEI E CIAR 
self. assert number is(int(expected)) 


FactorialSteps(world) 


(4) 在 PyCharm 工具 的 Terminal( 终 端 ) 中 ,或 者 CMD 中 ,将 当前 的 工作 目录 切换 到 
features 目录 所 在 目录 中 ,然后 执行 “lettuce > testReport. log"; 

执行 结果 : 

执行 结束 后 ,将 会 在 features 目录 作者 目录 下 产生 一 个 testReport. log 文件 ,里 面 内 
容 即 为 直接 通过 “lettuce” 命 令 执 行 时 打印 到 屏幕 上 的 测试 过 程 信息 ,将 其 重 定向 到 文件 
中 ,方便 后 续 查 看 ,文件 内 容 如 图 13-6 所 示 , 但 这 样 得 到 的 输出 结果 中 ,每 一 步 都 被 打印 
THK. 

代码 解释 : 

本 实例 将 13. 3 节 中 的 步 又 方法 封装 到 类 FactorialSteps 中 ,并且 使 用 @steps 注解 进行 
修饰 类 FactorialSteps ,表示 此 类 中 集合 了 多 个 步骤 ,同时 内 部 修饰 @steps 和 _ init — Jrik 
组 成 闭 包 ,表示 _ init _ 方法 将 和 @steps HFE. 

类 模式 的 行为 驱动 中 ,关键 字 exclude 列表 中 列 出 的 方法 名 或 以 下 画 线 ” "开始 的 方法 
将 不 会 被 认为 是 测试 步骤 ,行为 驱动 测试 执行 过 程 中 不 会 被 lettuce 主动 执行 ,比如 本 实例 
中 的 exclude = ['set number'. 'get number' ] 中 的 两 个 方法 以 及 _assert_number_is 方法 
均 不 会 被 当成 行为 驱动 测试 步骤 而 被 lettuce 执行 。 
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在 自动 化 测试 实施 过 程 中 


Aog MMOYOuOVvauwNHODDMUOmDewNHmrooouoeunewws 


Nm 四 四 wow 


let 
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Feature: Compute factorial 
In order to play with Lettuce 
As beginners 
We'll implement factorial 


Scenario: Factorial of 0 
Given I have the number 0 
Given I have the number 0 
When I compute its factorial 
When I compute its factorial 
Then I see the number 1 
Then I see the number 1 

Scenario: Factorial of 1 
Given I have the number 1 
Given I have the number 1 
When I compute its factorial 
When I compute its factorial 
Then I see the number 1 
Then I see the number 1 

Scenario: Factorial of 2 


Given I have the number 2 
Given I have the number 2 
When I compute its factorial 
When I compute its factorial 
Then I see the number 2 
Then I see the number 2 


Scenario: Factorial of 3 
Given I have the number 3 
Given I have the number 3 
When I compute its factorial 
When I compute its factorial 
Then I see the number 6 
Then I see the number 6 


1 feature (1 passed) 


4 scenarios (4 passed) 
12 steps (12 passed) 


图 


ce 框架 的 步 





-— 


-————— "5 hm 


-—— 


执行 


\features\zero. feature: 
\features\zero. feature: 
\features\zero. feature: 
\features\zero. feature: 


\features\zero. feature: 
\features\steps.py:35 
\features\steps.py:35 
\features\steps.py:42 
\features\steps.py:42 
\features\steps.py:48 
\features\steps.py:48 


\features\zero. feature: 
\features\steps.py:35 
\features\steps.py:35 
\features\steps.py:42 
\features\steps.py:42 
\features\steps.py:48 
\features\steps.py: 48| 


\features\zero. feature: 
\features\steps.py:35 
\features\steps.py:35 
\features\steps.py:42 
\features\steps.py:42 
\features\steps.py:48 
\features\steps.py:48 


\features\zero. feature 
\features\steps.py:35 

\features\steps.py: 
\features\steps.py: 
\features\steps.py: 
\features\steps.py: 
\features\steps.py: 


gt 
HR 


概述 


13-6 


RAUR RIE 


很 容易 实现 向 数据 或 文件 等 中 写 人 大 量 的 不 同 数据 。 


实例 : 


CD 在 PyCharm 工具 中 创建 如 下 所 示 的 目录 结构 及 文件 。 


|lettuce 


| StepDataTables 


| features 


一 student. feature 
一 steps.py 


(2) student. feature 文件 具体 内 容 如 下 所 示 : 


Feature:bill students alphabetically 
In order to bill students properly 


uN 


11 


:21 


,经 常会 遇 到 在 测试 用 例 执 行 过程 中 的 某 一 步 或 某 几 步 需 要 
往 文件 或 数据 库 中 添加 大 量 不 同 数据 的 场景 ,同时 还 会 检查 一 下 这 些 数据 添加 后 的 新 状态 ， 
lettuce 框架 也 为 此 种 情况 提供 了 很 好 的 支持 ,只 需要 使 用 lettuce 框架 的 步骤 数据 表格 即 可 


st 
o 


Selenium WebDriver 3.0 一 | 自动 化 测试 框架 实战 指南 


As a financial specialist 
I want to bill those which name starts with some letter 


Scenario: Bill students which name starts with "G" 
Given I have the following students in my database: 


name monthly due billed 
Anton $ 500 no 
Jack $ 400 no 
Gabriel $ 300 no 
Gloria $ 442.65 no 
Ken $ 907.86 no 
Leonard $ 742.84 no 
When I bill names starting with "G" 
Then I see those billed students: 
nane monthly due billed 
Gabriel $ 300 no 
Gloria $ 442.65 no 
And those that weren't: 
name monthly due billed 
Anton $ 500 no 
Jack $ 400 no 
Ken $ 907.86 no 
Leonard $ 742.84 no 














Given, Then 及 And 步骤 下 都 存在 步 又 数据 表格 ,数据 间 以 “| "进行 分 隔 ,数据 表 的 第 
一 行 表示 数据 表 的 列 名 ,不 作为 数据 存在 。 

G) steps. py 文件 ,用 于 编写 获取 student. feature 文件 中 的 数据 ,并 提供 后 续 操 作 , 具 
体内 容 如 下 : 


#encoding= utf -8 
from lettuce import * 


@step('I have the following students in my database:') 
def students in database(step): 
if step.hashes: 
# OUR FE TE IPTE ME AHE, 则 继续 后 续 步 又 
print type( step. hashes) 
assert step. hashes 
| 


name': 'Anton', 
'monthly due': '$ 500", 
"billed': ' 


no 


: 'Jack', 
'monthly due': ' $ 400', 
'billed': ' 


no 


'name': 'Gabriel', 
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'monthly due': '$ 300', 
'billed': 'no' 

Lh 

{ 


name 
'monthly due': '$ 442.65', 
'billed': 'no' 


: 'Gloria', 


'name': 'Ken', 
'monthly due': ' $ 907.86', 
'billed': 'no' 


'name': 'Leonard', 
'monthly due': '$ 742.84', 
"billed' : 'no' 

n 


@step('I bill names starting with "(. * )"') 

def natch starting(step, startAlpha): 
# 将 通过 正 刚 表 让 式 匹配 步 又 中 蝴 后 一 个 字母 , 
# OJHET 4 ERE startAlpha 中 
world.startAlpha - startAlpha 
print step. hashes 


(uU step('I see those billed students: ') 
def get starting with G student(step): 
# WERE REI CIS 
for i in step. hashes: 
# 断言 学 生 的 名 字 是 再 以 world. startAlpha X fF h FEIA 
assert i["name" ]. startswith(world. startAlpha) 


@step("those that weren't:") 
def result(step): 
for j in step. hashes: 
# 断言 学 生 名 字 不 以 world. startAlpha Y EFRA FEIA 
assert world. startAlpha not in j["name" ][0] 


执行 结果 : 

Feature: bill students alphabetically # \features\data. feature:1 
In order to bill students properly £ \features\data. feature:2 
As a financial specialist £ \features\data. feature:3 
I want to bill those which name starts with some letter £ \features\data. feature:4 
Scenario: Bill students which name starts with "G" # MfeaturesVdata. feature:6 

Given I have the following students in my database: £ \features\steps. py:5 
Given I have the following students in my database: £ MfeaturesVsteps. py:5 
| name | monthly due | billed | 


2 * 


Selenium WebDriver 3.0 一 | 自动 化 测试 框架 实战 指南 


Anton $ 500 no | 

Jack $ 400 no | 

Gabriel $ 300 no | 

Gloria $ 442.65 no | 

Ken $ 907.86 no | 

Leonard $ 742.84 no | 
When I bill names starting with "G" # MfeaturesVsteps. py:41 
When I bill names starting with "G" # MfeaturesVsteps. py:41 
Then I see those billed students: £ MfeaturesVsteps. py:48 

name monthly due billed | 

Gabriel $ 300 no | 

Gloria $ 442.65 no | 
And those that weren't: # MfeaturesVsteps. py:55 

name monthly due | billed 

Anton $ 500 no | 

Jack $ 400 no | 

Ken $ 907.86 no | 

Leonard $ 742.84 no | 











1 feature (1 passed) 

1 scenario (1 passed) 

4 steps (4 passed) 

代码 解释 : 

执行 测试 脚本 中 的 步骤 函数 时 ,lettuce 框架 自动 将 Given, Then 及 And 步骤 中 的 数据 
表格 中 的 数据 转换 成 一 个 可 迭代 的 数据 对 象 list,list 中 的 每 一 个 元 素 都 是 数据 表 中 每 一 行 
数据 组 成 的 以 列 名 为 key, 列 中 的 数据 为 value 的 字典 对 象 , 然 后 直接 通过 访问 step. hashes 
属性 就 可 以 取 到 存储 的 这 些 数 据 ,以 便 提供 给 后 续 提 取 数 据 的 使 用 。 


行为 驱动 场景 中 的 每 一 步骤 都 可 以 有 自己 的 步骤 数据 表格 。 





13.6 WEE WebDriver 进行 英文 语言 的 行为 数据 驱动 测试 





测试 逻辑 : 
(1) 访问 http://www. sogou. com, 
(2) 依次 搜索 几 个 球星 的 英文 名 字 中 的 一 部 分 。 
G) 在 搜索 结果 页 面 断言 搜索 的 球星 的 全 名 。 
实例 : 
(1) 在 PyCharm 工具 创建 如 下 所 示 的 目录 结构 及 文件 。 
|lettuce 
| BddDataDrivenByEnglish 
| features 
— sogou. feature 


— sogou. py 
— terrain.py 
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(2) sogou. feature 文件 用 于 存放 数据 驱动 所 需要 的 数据 ,具体 内 容 如 下 : 


Feature:Search in Sogou website 
In order to Search in Sogou website 
Rs a visitor 
We'll search the NBA best player 


Scenario: Search NBA player 
Given I have the english name "< search name >" 
When I search it in Sogou website 
Then I see the entire nane "< search result >" 


Examples: 
| search name| search result| 
| Jordan | Michael | 
| Curry | Stephen | 
| Kobe | Bryant | 


Examples 下 面 是 一 个 场景 数据 表 ,数据 间 以 ”| "进行 分 隔 ,数据 表 的 第 一 行 表 示 列 名 ， 
与 场景 中 的 变量 名 对 应 ,比如 Given I have the English name "< search_name >" 语 句 中 的 
search name 对 应 数据 表 中 的 search. name 列 。 

(3) sogou. py 文件 编写 实施 结合 行为 驱动 的 数据 驱动 测试 ,具体 内 容 如 下 : 


# encoding = utf - 8 

from lettuce import * 

from selenium import webdriver 
import time 


(Uu step('I have the english name "(. * )"') 

def have the searchWord(step, searchWord): 
world.searchWord - str(searchWord) 
print world. searchWord 


@step('I search it in Sogou website') 

def search in sogou website(step): 
world.driver = webdriver.Firefox(executable path = "c:\\geckodriver") 
world.driver.get("http://www. sogou. com" ) 
world.driver.find element by id("query").send keys(world. searchWord) 
world.driver.find element by id("stb").click() 
time. sleep(3) 


@step('I see the entire name "(. * )"') 

def check result in sogou(step, searchResult) : 
assert searchResult in world.driver.page source, "got word: $ s" % searchResult 
world.driver.quit() 


(4). terrain. py 文件 用 于 在 测试 过 程 中 和 测试 结束 后 打印 日 志 , 具 体内 容 如 下 : 


s encoding = utf - 8 
from lettuce import * 
import logging 
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# WW HENK 
logging. basicConfig( 
# HERH 
level = logging. INFO, 
# HERR 
2 BEE ARN TEXTES ABIT G HERE F H E 
format = '% (asctime)s % (filename)s[line: % (lineno)d] % (levelname)s % (message)s', 
# 打印 日 起 的 时 间 
datefmt = '$a, $Y- $m-$d $H:$M:$5S', 
# 日 志文 件 存放 的 有 目录 (目录 必须 存在 ) 及 日 志文 件 各 
filename = 'D:/lettuce/BddDataDrivenByEnglish/BddDataDriveRreport. log', 
# 打开 日 志文 件 的 方式 
filemode = 'w' 
) 
# TEIA PS HAT T 
@before.all 
def say hello(): 
logging. info("Lettuce will start to run tests right now...") 
print "Lettuce will start to run tests right now..." 


# 在 每 个 secnario Ft AIT MÍT 

(àbefore.each scenario 

def setup some scenario(scenario): 
# 4f Scenario JF tlli, IT NARE EF 
print 'Begin to execute scenario name:' * scenario.name 
# MOFUHATISTS SUE TTEUEIH E 


logging. info('Begin to execute scenario name:' * scenario.name) 


# 每 个 step 开始 所 执行 
(übefore.each step 
def setup some step(step): 
run = "running step $r, defined at $ s" % ( 
step. sentence, # WITJE 
step. defined at. file # ÆRE Y TE MNZ IE 
) 
# 将 每 个 场 尹 的 每 一 步 乱 息 打 印 到 日 志 
logging. info(run) 


# d step WIT AIT 
@after. each_step 
def teardown some step(step): 
logging. info("End of the ' $s'" % step. sentence) 


# 在 每 个 secnario 执行 结束 执行 

(Qafter.each scenario 

def teardown some scenario(scenario): 
print ''finished, scenario name:' + scenario. name 
logging. info('finished, scenario name:' + scenario.name) 


# EMA GRITAR BA fT 
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@after. all # 上 默认 获取 执行 结果 的 对 象 作为 total 参数 
def say goodbye(total): 
result = "Congratulations, %d of %d scenarios passed!" * ( 
total.scenarios ran, £Z —Jt/44gisfíry 
total.scenarios passed # —JE ^P stis TIRY T 
) 


print result 


logging. info(result) 

# 将 调试 结 黑 写 人 日 志文 件 

logging. info(" Goodbye! " ) 

print" -esese Goodbye! ------ s 









mt, defined at \festures\sogou.py 


defined at \testures\sogou-py 











1n.py[line:46] 
in.py[lines41] 
train.py[1ine:46] 
in.py[line:41] 
in.pyl Line: 46] 
in.py[Line:41] 
in.py[line:46] T 
in.pylline:4l] I 


t \features\sogou.py 






t \festures\sogou.py 














*, defined at \features\sogou.py 
, defined at \features\sogou.py 


*, defined at Vfeatures 





+ defined at Vteaturesisogou.py 






pylline:62) 
rain.py[lime:é4] 1 





18. 7/ fT i 数据 驱动 测试 





测试 逻辑 : 

(1) 访问 http://www. baidu. com。 

(2) 依次 搜索 几 本 中 文 名 字 的 书 。 

CD 在 搜索 结果 页 面 断言 是 否 出 现 书 的 预期 作者 。 
实例 : 

(1) 在 PyCharm 工具 创建 如 下 所 示 的 目录 结构 及 文件 。 


|lettuce 
|BddDataDrivenByChinese 
|features 
— baidu. feature 
— baidu. py 
— terrain. py 
一 log. py 


(2) baidu. feature 文件 内 容 如 下 : 


# encoding = utf - 8 
# language: zh- CN 
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特性 : 在 百度 网 站 搜索 IT 相关 书籍 
能 够 搜索 到 书 的 作者 , 比如 吴 晓 华 


场景 : 在 百度 网 站 搜索 IT 相关 书籍 
如 果 将 搜索 词 设 定 为 书 的 名 字 "< 书 名 >” 
当 打开 百度 网 站 
和 在 搜索 输入 框 中 输入 搜索 的 关键 词 , 并 单 击 搜索 按钮 后 
那么 在 搜索 结果 中 可 以 看 到 书 的 作者 "< 作者 >” 


例如 : 
| 书 名 1 作者 | 
| Selenium WebDriver 实战 宝典 ”| 吴 晓 华 | 
| HTTP 权威 指南 | 古 尔 利 | 
| Python 核心 编程 IER | 


(3) baidu. py 文件 内 容 如 下 : 


#encoding= utf - 8 

# language: zh- CN 

from lettuce import * 

from selenium import webdriver 
import time 


@step(u' 将 搜索 词 设 定 为 书 的 名 字 "(. * )"') 
def have the searchWord(step, searchWord): 
world.searchWord - searchWord 
print world. searchWord 


@step(u' 打 开 百 度 网 站 ') 

def visit baidu website(step): 
world.driver = webdriver.Firefox(executable path = "c: WM geckodriver" ) 
world. driver.get(" http://www. baidu. com" ) 


@step(u' 在 搜索 输入 框 中 输入 搜索 的 关键 词 ,并 单 击 搜索 按钮 后 ') 

def search in sogou website(step): 
world.driver.find element by id("kw").send keys(world.searchiord) 
world.driver.find element by id("su").click() 
time.sleep(3) 


@step(u' 在 搜索 结果 中 可 以 看 到 书 的 作者 "(. * )"') 

def check result in sogou(step, searchResult): 
assert searchResult in world.driver.page source, "not got words: % s" % searchResult 
world.driver.quit() 


(4) terrain. py 文件 内 容 如 下 : 
# encoding = utf - 8 


from lettuce import * 
from log import * 


* dEBCB ERU ITAIT 
(Qbefore.all 
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def say hello(): 
logging. info(u" 开始 执行 行为 数据 驱动 测试 ..…”) 


# 在 每 个 secnario 开始 执行 鹿 热 行 
(übefore.each scenario 
def setup some scenario(scenario): 
# FIHI OEC ELTTEREIH E 
logging. info(u' 开 始 执行 场景 " s" ' * scenario. name) 


# 每 个 step 开始 所 执行 
(Qbefore.each step 
def setup some step(step): 
world.stepName - step.sentence 
run = u" 执 行 步骤 " & s", 定义 在 "$s "文件 w 
step. sentence, # WITHA 
step. defined at. file # PRENER Xf 
) 
# MERE SU dE — IPLE TERRI H E 
logging. info(run) 


* 每 个 step 热 行 后 热 行 
@after. each step 
def teardown some step(step): 
logging. info(u" 3p UR" % s" 执 行 结 束 ”$% world. stepNane) 


# 在 每 个 secnario fA TIAM IA fT 
@after. each scenario 
def teardown some scenario(scenario): 
logging. info(u'15 &" % s" 执行 结束 ' % scenario. name) 


# EHUÉ PERUATADE RITU 
@after. all £ BEA JERWGHAETAA AR IRH total 参数 
def say goodbye(total): 
result = 岂 恭 喜 , $d 个 场景 运行 , 5d 个 场景 运行 成 功 ”s ( 


total.scenarios ran, z—JH E^ 5g iy 
total.scenarios passed 2—HE^aM/5 gg iHF 


) 

logging. info(result) 

EO AIR TRA HEX 

logging. info(u" 本 次 行为 数据 驱动 执行 结束 ") 


C5) log. py 文件 用 于 编写 初始 化 日 志 对 象 的 程序 ,具体 内 容 如 下 : 


# encoding = utf - 8 
import logging 


# WHER 
logging. basicConfig( 
# HERH 
level = logging. INFO, 
# Hd 
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# 时间 .代码 所 在 文件 各、 代码 行 寻 ,日 志 级 别名 他、 日 志 信 息 
format = '% (asctime)s % (filename)s[line: % (lineno)d] % (levelname)s % (message)s', 
# 打印 日 志 的 时 间 
datefmt = '%a, %Y- $m-$d $H:$M:$5S', 
# 日 志文 件 郑 放 的 目录 (目录 必须 存在 ) 及 日 志文 件 各 
filename = 'D:/lettuce/BddDataDrivenByChinese/BddDataDriveRreport. log', 
# 打开 日 志文 件 的 方式 
filemode = 'w' 
) 


执行 结果 : 
执行 结束 后 日 志文 件 BddDataDriveRreport. log 的 内 容 如 图 13-8 所 示 。 


E] 





控制 台 输 出 如 图 13-9 所 示 


性 : 在 百度 网 站 搜索 IT 相关 书籍 atures\baidu. feature:4 
能 够 搜索 到 书 的 作者 ， 比 如 吴 晓 华 features\baidu. feature:5 


场景 模板 : 在 百度 网 站 搜索 IT 相关 书籍 eatures baidu. feature:7 
mque 5e we features Vbaidu. py:8 
Selenium WebDriver 实 战 宝典 
当 打开 百度 网 站 
和 在 搜索 输入 框 中 输入 搜索 的 关键 语 ， 并 点 击 搜索 技 钮 后 
那么 在 搜 果 中 可 以 看 到 书 的 作者 《作者 >” 


fe | 
5B | 


古 尔 利 | 


Python 核 心 编程 
| Python 核心 编程 Em | 


feature (1 passed) 
marios (3 passed) 
12 steps (12 passed) 





图 13-9 
代码 解释 : 
lettuce 支持 中 文 语言 编写 的 测试 场景 ,是 通过 在 场景 文件 以 及 测试 场景 的 脚本 文件 的 
顶部 添加 # language: zh-CN., 声 明 使 用 的 语言 为 中 文 ,同时 . feature 文件 的 编码 必须 保存 
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为 utf-8。 


在 baidu. feature 文件 中 ,关键 词 与 后 面 的 描述 信息 间 的 冒号 (:) 必须 是 英 
文字 符 的 冒号 。 








行为 驱动 用 例 集 


lettuce 支持 一 次 执行 多 个 用 例 , 也 就 是 放 到 features 目录 下 的 多 个 . feature 文件 。 
实例 : 
在 PyCharm 工具 中 创建 如 下 所 示 的 目录 结构 及 文件 。 


|lettuce 
|MultipleFeatures 

| features 
— Login Chinese. feature 
— Login Chinese. py 
— Login English.feature 
- Login English. py 

— terrain. py 


Login. Chinese. feature 文件 具体 内 容 如 下 : 


st encoding - utf - 8 
# language: zh- CN 


特性 : 登录 126 邮箱 和 退出 126 邮箱 登录 


场景 : 成 功 登 录 126 邮箱 
假如 启动 一 个 浏览 器 
当 用 户 访 问 http://mail. 126. com 网 址 
当 用 户 输入 用 户 名 "xxx" 和 密码 "oex" 
那么 页 面 会 出 现 "未 读 邮 件 "关键 字 
场景 : 成 功 退 出 126 邮箱 
当 用 户 从 页 面 单 击 退出 链接 
那么 页 面 显 示 " 您 已 成 功 退 出 网 易 邮 箱 " 关 键 内 容 


Login Chinese. py 文件 内 容 如 下 : 





示 


#encoding= utf - 8 
# language: zh- CN 

from lettuce import * 

from selenium import webdriver 

from selenium. webdriver. common. keys import Keys 


import time 


@step(u' 启 动 一 个 浏览 器 ') 
def open browser(step): 
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try: 
# 创建 Chrome X AHI driver 实例 ,并 存 于 全 局 对 象 world rfi, 
* USES BUX ETE PRECII 
world.driver = webdriver.Chrome(executable path = "c: VV chromedriver" ) 
except Exception, e: 


raise e 


@step(u' 用 户 访问 (. * ) 网 址 ') 

def visit url(step, url): 
print url 
world.driver.get(url) 


@step(u' 用 户 输入 用 户 名 "(. * )" 和 密码 "(. * )"') 
def user enters UserName and Password(step, username, password): 
print username, password 
# ONIS T O REKE 
world. driver. maximize window() 
time. sleep(3) 
# 切换 进 frame fff 
world. driver. switch to.frame("x- URS - iframe") 
# KMPH A HE 
userName = world. driver. find_element_by_xpath( '//input[@name = "email" ]') 
# 输 人 用户 名 
userName. send keys(username) 
# HKA A fie 
pwd = world.driver.find element by xpath("//input[(Zname = 'password']") 
BAM 
pwd. send keys(password) 
# RPE 
pwd. send keys(Keys. RETURN) 
E GEIF 15 秘 ,以便 登录 后 成 功 进 人 登录 后 的 页 面 
time. sleep(15) 


@step(u' 页 面 会 出 现 "(. * )" 关 键 字 ') 
def nessage displayed Login Successfully(step, keywords): 
# print world.driver.page source. encode( 'utf - 8') 
# 肠 言 登录 成 功 后 ,页面 是 否 出 再 珊 甚 的 关键 字 
assert keywords in world. driver. page_source 
# 肠 言 成 功 后 ,打印 登录 成 功 信 息 
print "Login Success" 


@step(u' 用 户 从 页 面 单 击 退 出 链接 ') 
def LogOut from the Application(step): 
print " ====", world. driver 
# time. sleep(5) 
# iliB ih tet, iB HER 
world.driver.find element by link text(u"jB tH" ) .click() 
time.sleep(4) 
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@step(u' 页 面 显示 "(. * "XS NS) 

def displayed LogOut Successfully(step, keywords): 
# 肠 言 退出 登录 后 , IB E S BGB HIE EE 
assert keywords in world.driver.page source 
print u"Logout Success" 
# iB ih d AE 
world. driver. quit( ) 


Login English. feature 文件 内 容 如 下 : 





# encoding = utf - 8 
Feature: login and logout 


Scenario: Successful Login with Valid Credentials 
Given Launch a browser 
When User visit to http://mail. 126.com Page 
And User enters UserName"xxx" and Password"xxx" 
Then Message displayed Login Successfully 
Scenario: Successful LogOut 
When User LogOut from the Application 
Then Message displayed LogOut Successfully 


Login English. py 文件 内 容 如 下 : 


# encoding - utf - 8 

from lettuce import * 

from selenium import webdriver 

from selenium. webdriver. common. keys import Keys 
import time 


(à step( 'Launch a browser') 
def open browser(step): 
try: 
world.driver = webdriver.Chrome(executable path- "c: V chromedriver" ) 
except Exception, e: 


raise e 


@step( 'User visit to (. * ) Page") 
def visit url(step, url): 
world.driver.get(url) 


(üstep('User enters UserName"(. + )" and Password" (. * )"') 

def user enters UserName and Password(step, username, password): 
world.driver.maximize window() 
time. sleep(3) 
world.driver.switch to.frame("x- URS- iframe") 
userName = world.driver.find element by xpath('//input[(2 name = "email"]') 
userName. send keys(username) 
pwd = world.driver.find element by xpath(" //input[ @name = ' password' ]" ) 
pwd. send keys(password) 
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pwd. send keys(Keys. RETURN) 
time.sleep(15) 


(à step( 'Message displayed Login Successfully') 

def nessage displayed Login Successfully(step): 
# print world.driver.page source. encode( 'utf - 8') 
assert u" 未 读 邮 件 " in world.driver.page source 
print "Login Success" 


(üstep('User LogOut from the Application') 
def LogOut from the Application(step): 
print" z",world.driver 
£ time.sleep(15) 
world.driver.find element by link text(u"iB tH") .click() 
time. sleep( 4) 





@step( 'Message displayed LogOut Successfully') 

def displayed LogOut Successfully(step): 
assert u" 您 已 成 功 退 出 网 易 邮 箱 ” in world. driver.page source 
print u"Logout Success" 
world.driver.quit() 


terrain. py 文件 内 容 用 于 统计 各 个 场景 执行 结果 信息 ,具体 内 容 如 下 : 


#encoding= utf - 8 
from lettuce import * 


# EA HAT D ÍT 
(à before.all 
def say hello(): 
print u" 开始 执行 行为 数据 驱动 测试 ..…" 


# 在 每 个 secnario JF AA fT I DAL £T 
(before. each scenario 
def setup some scenario(scenario): 
print u' 开 始 执行 场景 " % s" % scenario. name 


# 在 每 个 secnario 执行 结束 后 执行 
@after. each_scenario 
def teardown some scenario(scenario): 
print u' 场 景 " $ s" 执 行 结 束 ' % scenario. name 


# EA RRITAR ART 
Gafter.all £ HURRA ARI REH total 参数 
def say goodbye(total): 
result = wA E, $d 个 场景 被 运行 , Sd 个 场景 运行 成 功 ” s ( 
total.scenarios ran | £ —Jt£'/L5tisíir 
total.scenarios passed # —JEt bI gef MY. 
) 
print result 
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将 Login Chinese. feature 和 Login English. feature 文件 中 的 xxx 字符 替换 成 有 效 的 
126 邮箱 登录 账号 及 密码 ,然后 在 PyCharm 工具 的 Terminal( 终 端 ) 中 ,或 者 CMD 中 ,将 当 
前 的 工作 目录 切换 到 features 目录 所 在 目录 中 ,然后 执行 lettuce 命令 ,启动 行为 驱动 测试 。 

结果 说 明 : 

lettuce 可 以 一 次 性 执行 多 个 . feature 文件 ,用 户 只 需要 将 写 好 的 多 个 . feature 文件 放 
入 features 目录 中 即 可 ,至 于 terrain. py 文件 ,可 以 放 在 features 目录 中 ,也 可 以 放 在 跟 
features 目录 同 级 的 目录 中 。 步 又 函数 中 的 print 语句 执行 的 结果 ,只 能 在 执行 过 程 中 在 控 
制 台中 能 看 到 ,但 不 会 被 保留 在 输出 结果 信息 中 。 
更 多 说 明 : 
此 程序 在 Selenium 3. x 和 Firefox 浏览 器 上 运行 会 抛 出 WebDriverException: 
Message: can't access dead object 异常 ,出 现 此 异常 的 原因 目前 还 不 是 特别 清楚 ,可 能 是 
Selenium3. x 版 本 的 bug, 也 可 能 是 高 版 本 Firefox 浏览 器 的 保护 机 制导 致 的 ,如 果 读 者 确 
实 想 在 Firefox 浏览 器 上 执行 此 程序 ,可 以 将 Selenium 降 到 2. x 版 本 (比如 2. 53. 6,Firefox 
可 以 用 47. 0. 2 或 者 43.0.4 版 本 ) 。 





13.9 M 解决 中 文 描述 的 场景 输出 到 控制 台 乱 码 





在 默认 编码 为 GBK 的 Windows 系统 中 执行 场景 使 用 中 文 描述 的 行为 驱动 测试 时 , 打 
印 到 控制 台 的 场景 等 信息 ,中 文 会 出 现 乱码 ,这 是 由 于 lettuce 框架 将 输出 到 控制 台 的 场景 
描述 信息 转 成 UTF8 编码 的 字符 导致 的 。 下 面 针 对 lettuce (0. 2. 23) 版 本 给 出 具体 解决 
方法 。 

(1) 进入 Python 安装 目录 中 lettuce 安装 路 径 中 的 plugins 目录 中 ,比如 笔者 的 本 地 路 
径 为 C:\Python27\ Lib\site-packages\lettuce\ plugins. 

(2) 找到 该 目录 下 的 colored shell output. py 文件 ,如 图 13-10 所 示 。 


» Windows? OS (C) » Python27 » Lib » site-packages » lettuce » plugins 














新 建文 件 夫 

E 修改 日 其 类 型 大 小 
Bb init py 2014/4/2 2:47 JetBrains PyChar. 1KB 
Boi py 2016/12/9 17:34 Compiled Pytho. 1KB 
Bi autopdb.py 2014/4/2 2:47 JetBrains PyChar... 1KB 
itopdb pyc 2016/12/9 17:34 Compiled Pytho. 2KB 
2016/12/16 11:52 JetBrains PyChar... 10KB. 
co | shell output.pyc 2016/12/16 12:07 Compiled Pytho. 10 KB 
Li dots.py 2014/4/2 2:47 JetBrains PyChar... 2KB 
P dots.pyc 2016/12/9 17:34 Compiled Pytho. 2KB 
Bisanta MENNAD ep mk ovo 

图 13-10 


(3) 打开 该 文件 ,找到 该 文件 的 第 32 行 代 码 what = what. encode('utf-8'), 将 其 改 成 
what = what£. encode('utf-8' 0 ,或 者 将 包裹 what = what. encode('utf-8') 代 码 的 整个 if 
语句 块 一 起 去 掉 , 如 图 13-11 所 示 。 
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SS 





25 from le tene terrain import after 
26 from lettuce. terrain import before 
27 from le og terrain import world 








30 def xd t (what) : 
E. zi EH escode(* TE -8*)] 
33 at) 
3 BIS gotas dogs 


图 13-11 


(4) 然后 保存 对 该 文件 的 修改 ,再 次 执行 场景 使 用 中 文 描述 的 行为 驱动 测试 时 ,就 可 以 
看 到 控制 台中 打印 的 中 文正 常 显 示 , 如 13. 6 节 结 果 截 图 所 示 。 
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ENDE Selenium Grid 的 使 用 














Selenium Grid 组 件 专门 用 于 远程 分 布 式 测试 或 并 发 测试 ,通过 并 发 执行 测试 用 例 的 方 
式 可 以 提高 测试 用 例 的 执行 速度 和 效率 ,解决 界面 自动 化 测试 执行 速度 过 慢 的 问题 。 此 章 
为 高 级 自动 化 测试 人 员 的 必修 内 容 。 


14.1 Selenium Grid 简介 


前 面 章节 介绍 的 自动 化 测试 代码 均 是 在 本 地 计算 机 上 运行 的 ,在 自动 化 测试 用 例 不 多 
的 情况 下 ,一 台 计 算 机 可 以 在 较 短 的 时 间 内 运行 完 所 有 的 测试 用 例 , 并 给 出 测试 报告 。 但 是 
随 着 目前 计算 机 行业 的 快速 发 展 , 越 来 越 多 的 大 型 项 目 横 空 出 世 , 需 要 测试 人 员 在 较 短 的 时 
间 内 完成 成 百 上 千 个 测试 用 例 的 运行 ,此 时 仅 依靠 一 台 计 算 机 来 完成 这 么 多 用 例 的 执行 肯 
定 无 法 满足 实际 的 测试 要 求 。 另 外 , 越 来 越 多 的 项 目 对 浏览 器 的 兼容 性 要 求 也 越 来 越 高 , 需 
要 在 多 种 操作 系统 和 各 种 流行 的 浏览 器 以 及 不 同 版 本 间 进 行 兼容 性 测试 , 单 台 计算 机 很 难 
满足 这 样 的 需求 。 由 此 我 们 可 以 借助 分 布 式 的 方式 来 并 行 执行 大 量 的 测试 用 例 , 以 满足 缩 
短 测试 时 间 和 兼容 性 测试 的 要 求 。 

Selenium Grid 的 产生 就 是 为 了 解决 分 布 式 运行 自动 化 测试 用 例 的 需求 。 使 用 此 组 件 
可 以 在 一 台 计算 机 上 给 多 台 计 算 机 (不 同 操作 系统 和 不 同 版 本 浏览 器 环境 ) 分 发 多 个 测试 用 
例 从 而 并 发 执行 ,大 大 提高 了 测试 用 例 执行 效率 ,基本 满足 大 型 项 目 自动 化 测试 的 时 限 要 求 
和 兼容 性 要 求 。 

Selenium Grid 目前 有 两 个 版 本 ,一 个 是 1. 0 版 本 ,一 个 是 2. 0 版 本 。Selenium Grid 和 
Selenium RC 进行 了 合并 ,现在 下 载 一 个 selenium-server-standalone-3. xx. x. jar 文件 就 可 
以 使 用 了 。Selenium Grid 2 集成 了 Apache Ant, 可 以 同时 支持 Selenium. RC 的 脚本 和 
WebDriver 脚本 ,最 多 可 以 远程 控制 5 个 浏览 器 。 

Selenium Grid 使 用 Hub 和 Node 模式 ,一 台 计 算 机 作为 Hub( 管 理 中 心 ) 管 理 其 他 多 
个 Node( 节 点 ) 计 算 机 , Hub 负责 将 测试 用 例 分 发 给 多 台 Node 计算 机 执行 ,并 收集 多 台 
Node 计算 机 执行 结果 的 报告 ,汇总 后 提交 一 份 总 HUB SEM. 

的 测试 报告 ,如 图 14-1 所 示 。 


P ——. 
Hub; a 
> 在 分 布 式 测试 模式 中 ,只 能 有 一 台 作 为 ^ NODE 3 


Hub 的 计算 机 。 (Firefox on Ubuntv) 
> Hub 负责 管理 测试 脚本 ,并 负责 发 送 脚本 NODE1 PE a 
给 其 他 Node 节点 。 (Andri) 一 - 


> 所 有 的 Node 节点 计算 机 必须 先 在 作为 图 14-1 
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Hub 的 计算 机 中 进行 注册 ,注册 成 功 后 再 和 Hub 计算 机 通信 ,Node 节点 计算 机 会 
告 之 Hub 自己 的 相关 信息 ,例如 ,Node 节点 的 操作 系统 和 浏览 器 相关 版 本 。 

> Hub 计算 机 可 以 给 自己 分 配 执行 测试 用 例 的 任务 。 

> Hub 计算 机 分 发 的 测试 用 例 任 务 会 在 各 个 Node 计算 机 节点 执行 。 

Node: 

在 分 布 式 测试 模式 中 ,可 以 有 一 个 或 者 多 个 Node 节点 。 

Node 节点 会 打开 本 地 的 浏览 器 完成 测试 任务 并 返回 测试 结果 给 Hub。 

Node 节点 的 操作 系统 和 浏览 器 版 本 无 须 和 Hub 保持 一 致 。 

在 Node 节点 上 可 以 同时 打开 多 个 浏览 器 并 行 执行 测试 任务 。 


14.2 分 布 式 自 动 化 测试 环境 准备 


1. 下 载 JDK 1.8 安装 文件 

具体 操作 步骤 如 下 : 

COD 访问 https: //profile. oracle. com/myprofile/account/create-account. jspx, 先 注册 
Oracle 用 户 ,注册 过 程 请 参阅 页 面 提 示 信 息 , 需 要 使 用 个 人 有 效 邮 箱 进行 验证 才能 激活 正 
式 的 注册 用 户 。 

(2) 注册 成 功 后 ,在 页 面 http://www. oracle. com/index. html 进行 用 户 登 录 。 

G) 登录 成 功 后 ,访问 http://www. oracle. com/technetwork/java/javase/archive- 
139210. html , 单 击 Java SES ,进入 JDK 1.8 版 本 下 载 页 面 , 如 图 14-2 所 示 。 


For more intormation on the transition of products from th 
the Oracle Technology Network. visit the SDLC Decomme 


Y 


v v 


Y 


Jump to Java SE | Jump to Java EE | Jump to Ji 
Java SE 

Š Java SE 8 一 
$ JavaSET 

Š Java SE6 

$ Java SES 

& JavaSE 14 

$ JavaSE 13 

Š Java SE 12 

至 JavaSE11 

Š JRockit Family 

Š Java SE Tutorials 

Š JOK 1.3 Documentation 


& JDK 1.42 Documentation 





图 142 


CD 在 下 载 页 面 单 击 下 载 地 址 列表 最 上 方 链接 ,如 图 14-3 所 示 。 
(5) 跳 转 到 下 载 版 本 选择 页 面 , 勾 选 Accept License Agreement 后 ,选择 和 当前 操作 系 
统 位 数 对 应 的 JDK 1. 8 进行 下 载 ,如 图 14-4 所 示 。 
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The JOK includes tools useful for developing and testing programs writen in the Java programming 
language and running on the Java™ platomm 

WARNING: These older versions of ne JRE and JDK are provided to help developers debug 
issues in older systems. They are not updated with the latest security patches and are not 
recommended for use in producton 


Fot production use Oracle recommends downloading the latest JOK and JRE versions and 
allowing auto-update 

Only developers and Enterprise administrators should download these releases. 
Downloading these releases requires an oracle com account If you dont have an oracle com 
account you can use the links on the top of his page to learn more about it and register for one for 
free. 


For current Java releases. please consult he Oracle Software Download page 


. Java SE Development Kt Bu102 MP" 单 击 此 链接 


* Java SE Runtime Environment 8u102 





. tT 
* Java SE Development Kit 8u101 

* Java SE Runtime Environment 8u101 

* Server JRE (Java SE Runtime Environment) 8101 
* Java SE Development Kit 8u92 


图 14-3 


» Server JRE (Java SE Runtime Environment) 8 


5 jaicBut02-Anux-arm32 vip-hflLtar gz 
Š jdk-80102-Inux arm64-vip-hfiLtar.gz 


Š jdi8u102 linux 586.rpm 

Š jdk Bu102 imux 1586 .targz 

Š jak -su107 nux647pm 

Š jdk Bu102 Inux x644argz 

Š jdk-8u102-macosx-x64.dmg 

5 jd-8u102-solaris-sparcv9.tarZ 
Š jdk-8u102-solaris-sparcv9.tar.gz. 
Š jdk-8u102.solaris-x64.1arZ 


š -solaris-xt 
Hu ptm 
2 Motu? SNAN A gn 

64 位 
„Java SE Runtime Environment 8u102 


图 14-4 





2. 安装 JDK 与 配置 环境 变量 


具体 操作 步骤 如 下 : 

(1) 双击 下 载 好 的 JDK 1. 8 安装 包 进行 安装 操作 ,安装 
过 程 中 只 需要 一 直 单 击 “ 下 一 步 ” 按 钮 即 可 。 

(2) JDK 安装 完成 后 ,在 Windows 7 操作 系统 桌面 上 的 
“计算 机 ”图 标 上 单 击 鼠 标 右键 ,在 弹出 的 快捷 菜单 中 选择 
“属性 ”命令 ,如 图 14-5 所 示 。 

G) 在 弹出 的 Windows 窗口 右边 单 击 “高 级 系统 设置 ”， 
如 图 14-6 所 示 。 

OD 在 弹出 的 “系统 属性 ”对 话 框 中 单 击 “ 高 级 ”标签 栏 ， 
然后 单 击 “环境 变量 ?按钮 ,如 图 14-7 所 示 。 图 14-5 


. 287 - 








e 
s - Selenium WebbDriver 3.0 一 | 自动 化 测试 框架 实战 指南 
>、 一 


UM o» EHE » 系统 和 安全 ， 系统 

















RS 查看 有 关 计 算 机 的 基本 信息 
* 设备 管理 各 Windows 版 本 
9 zeen Windows 7 E443 
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图 14-6 
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(5) 在 弹出 的 “环境 变量 "对话 框 中 , 单 击 系统 变量 的 下 方 “新 建 "按钮 ,并 在 接 下 来 弹出 
的 对 话 框 的 变量 名 输入 框 中 输入 *JAVA_HOME” ,变量 值 输入 框 中 输入 JDK 1. 8 的 安装 目 
录 ( 比 如 笔者 的 安装 目录 为 C:\Program Files\Java\jdk1. 8. 0_73), 如 图 14-8 所 示 , 然 后 单 
击 “ 确 定 ” 按 钮 保存 . 回 到 “环境 变量 ”对话 框 。 

(6) 在 系统 环境 变量 中 找到 Path 变量 行 , 双 击 该 行 , 在 弹出 的 Path 环境 变量 的 编辑 界 
面 的 变量 值 输入 框 的 最 前 面 添加 “%JAVA_HOME%\bin; WJAVA_HOME%\jre\bin;”， 
如 图 14-9 所 示 ,然后 单 击 * 确 定 ? 按 钮 保存 修改 并 且 返 回 * 环 境 变量 "对话 框 。 

(7) 再 次 单 击 系统 变量 下 面 的 新建? 按钮 ,在 弹出 的 "新建 系统 变量 ?对话 框 中 ,在 “ 变 
量 名 ”输入 框 中 输入 *CLASSPATH”, 在 “变量 值 " 输 入 框 中 输入 “. ;%JAVA_HOME%A\ 
lib; %JAVA_HOME% lib\ tools. jar”( 注 意 最 前 面 有 一 点 ), 如 图 14-10 所 示 , 然 后 单 击 “ 确 
定 ” 按 钮 完成 Java 环境 变量 的 配置 步骤 。 
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变量 名 (N) : JAVA HONE | 
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图 14-8 
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图 14-9 














变量 值 (V) ; XJAVA_HONEX\lib\dt. jar;%JAYA_HONEY 
d E TA 
图 14-10 


(8) f WIN 十 R 组 合 键 ,在 弹出 的 “运行 "输入 框 中 输入 *cmd”, 如 图 14-11 所 示 ,然后 
TE Enter 键 , 调 出 CMD 对 话 框 ,并 在 CMD 界面 输入 “java -version”, 按 Enter 键 后 显示 出 
Java 的 版 本 信息 ,如 图 14-12 所 示 的 信息 ,表示 Java 环境 配置 成 功 
本 运行 - Es 
| Ey Windows 将 根据 您 所 输入 的 名 称 ,为 您 打开 相应 的 程序 、 文 
件 卖 、 文 档 或 nternet 资源 . 


mmo EE 


时 ”使 用 管理 权限 创建 此 任务 








Java 的 版 本 4 


ava (TM) Runtime Environment (build 1.8.0 b02) 
ava HotSpot (TM) 64-Bit Server VM (build 25. ，mixed mode) 
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14.3 SNe B: SEE DATA 


本 节 将 详细 讲解 Selenium Grid 的 配置 和 使 用 方法 ,请 读者 根据 本 节 内 容 在 本 地 计算 
机 网 络 内 尝试 搭建 分 布 式 测试 执行 环境 。 
14.3.1 远程 调用 Firefox 浏览 器 进行 自动 化 测试 


具体 操作 步骤 如 下 : 
CD 找到 两 台 Windows 系统 的 计算 机 A 和 B. A 计算 机 作为 Hub,B 计 算 机 作为 Node. 
(2) 两 台 计 算 机 均 访问 http://www. seleniumhq. org/download/ ,并 单 击 页 面 中 的 下 


C 盘 根 目录 中 。 


Selenium Standalone Server 









The Sel ded in order to run Remote Selenium WebDriver. Sel 
longer capa elenium RC directly, rather it does it through emulati 
WebDniver raet 

Download versio 3.0.1 ] 7 单 击 下 载 


To run Selenium tests exported from IDE, use the Selenium Html Runner 


图 14-13 


下 载 的 文件 为 最 新 的 版 本 ,本 例 中 下 载 的 是 文件 selenium-server-standalone-3. 0. 1.jar。 
G) 在 机 器 A 上 打开 CMD 窗口 ,将 当前 工作 目录 切换 到 C 盘 根 目 录 ( 也 就 是 
selenium-server-standalone-x. xx. x. jar 文件 所 在 目录 ) ,然后 执行 如 下 语句 : 


java- jar selenium- server - standalone- 3.0.1.jar - role hub 


role hub; 启动 一 个 Hub 服务 ,作为 分 布 式 管 理 中 心 ,等 待 WebDriver 客户 端 进行 注 
册 和 请 求 ,默认 接收 注册 的 地 址 为 http://localhost: 4444/grid/register, 上 默认 启动 端口 
为 4444。 

此 行 语句 表示 使 用 Java 命令 把 JAR 文件 作为 程序 执行 ,并 将 role 参数 值 传递 给 JAR 
文件 的 函数 ,以 此 启动 管理 中 心 ,如 图 14-14 所 示 。 
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(4) 在 机 器 A( 假 如 IP 地 址 为 192. 168. 1. 107) 中 的 Firefox 浏览 器 地 址 栏 中 访问 
http://localhost :4444/grid/console, 如果 访问 的 网 页 中 显示 出 “view config ”的 链接 ,表示 
Hub 已 经 成 功 启动 。 默 认 情 况 下 ,Selenium Grid 使 用 4444 作为 服务 端口 号 。 在 机 器 B 上 
也 可 以 访问 此 网 址 ,只 需要 将 "localhost” 换 成 A 机 器 的 IP 地 址 192. 168. 1. 107 即 可 ,访问 
地 址 为 http://192. 168. 1.107:4444/grid/console, 成 功 界面 如 图 14-15 所 示 。 








XXE) SRO HOD HLO HWD IAM MMH) 


E Grid Console x Wn 


€ 192.168.1.107:4444/grid. 


Grid Console v.3.0.1 


view config 


图 14-15 


(5) 在 机 器 BAP 地 址 为 192. 168. 1. 113) 中 打开 CMD 窗口 ,并 将 当前 工作 目录 切换 到 C 
盘 根 目录 (也 就 是 selenium-server-standalone-x. xx. x. jar 文件 所 在 目录 ) ,输入 如 下 命令 : 
java - jar selenium - server- standalone — 3. 0. 1. jar - role webdriver - hub http://192.168.1 


107:4444/grid/register — Dwebdriver. firefox. driver = "C: \ geckodriver. exe" port 6655 


maxSession 5 - browser browserName = "firefox", maxInstances = 5 


参数 说 明 : 

> role: 参数 值 webdriver 表示 Node( 节 点 ) 的 名 字 

> hub. 参数 值 表 示 管 理 中 心 的 URL 地 址 ,Node 会 连接 这 个 地 址 进行 节点 注册 。 

> port; 参数 值 表 示 Node 节点 服务 的 端口 号 为 6655 ,建议 使 用 大 于 5000 的 端口 号 
命令 执行 后 会 看 到 如 图 14-16 所 示 的 结果 








| EE CAWINDOWS\system32\cmd.exe - java -jar selenium-server-standalone-3.0.1 jar -role webdriver -hub http: 


k 10. 0. 14393] 
oration, PERITI BUE 


hub http 
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945 
950 INFO 


5: INFO: 0 
NFO: 0 rvletContextHandle: 
3: INFO: os j: e onector:main tortiSa63f509 [HTTP /1 
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46.004 INFO 
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tion th 3000 m 
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图 14-16 
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(6) 再 次 访问 网 址 http: //192. 168. 1. 107:4444/grid/console. J& iiE Node 节点 是 否 已 
在 Hub 上 注册 成 功 , 注 册 成 功 会 看 到 如 图 14-17 所 示 的 信息 。 


TZD S80 SEV FLO HIW IAT NBH 
E Grid Console x 


É) O localhost4444/grid/console= 


a 


å, 
Se Grid Console v.3.0.1 
rowers BERI 
WebDriver 
CILLI] 
vë 
TAALLA 


view config 





图 14-17 


从 此 页 面 可 以 获取 到 节点 计算 机 允许 不 同 种 类 的 浏览 器 打开 多 少 个 实例 ,验证 节点 计 
算 机 执行 命令 行 的 正确 性 。 

(7) 编写 分 布 式 执行 的 测试 脚本 。 

测试 逻辑 : 

fii FH Firefox 浏览 器 访问 sogou 首页 ,进行 关键 词 *webdriver 实战 宝典 ”的 搜索 ,并 验证 
搜索 结果 页 面 源 码 中 是 否 出 现 “ 吴 晓 华 ” 关 键 内 容 。 

测试 脚本 : 


& encoding - utf - 8 
from selenium import webdriver 
from selenium. webdriver. common. keys import Keys 


import time 


driver - webdriver.Remote( 
* UUE Node 节点 的 URL 地 址 ,后 缕 将 通过 访问 这 个 地 址 连接 到 Node 计算 机 
command executor = 'http://192.168.1.113:6655/wd/hub', 
desired capabilities = ( 
# MEt Ei SEL EAG N E SE Firefox 
"browserName" : "firefox", 
"video": "True", 
# 远程 计算 机 的 平台 
"platform" : "WINDOWS" 
n 


print ("Video: " + "http://www. baidu. com" + driver. session_id) 


try: 
driver. implicitly wait(30) 
driver.maximize window() 
driver.get(" http://www. sogou. com" ) 
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assert u" 搜狗 ”in driver. title 
elem = driver.find element by id("query") 
elem. send keys(u"webdriver 实战 宝典 ") 
elem.send keys(Keys. RETURN) 
time. sleep(3) 
assert u" & BE AE" in driver.page source 
print 'done! ' 

finally: 
driver.quit() 


测试 结果 : 


在 机 器 B 上 可 以 看 到 ,计算 机 会 自动 启动 Firefox 浏览 器 执行 测试 脚本 ,执行 完毕 后 浏 
览 器 会 自动 退出 。 在 机 器 A 上 可 以 看 到 自动 化 测试 的 执行 结果 ,如 图 14-18 所 示 。 

















|n? gis 
bot C. Wythes2T python. exe D. /PythonPro ject/BultipleFeaturez/grid py 
ii 
"ns 
gn renes Gimished sith enit ende 0 
图 14-18 
作为 Hub 启动 时 部 分 参数 的 含义 如 表 14-1 所 示 。 
表 14-1 
参数 名 称 参数 含义 
-role hub 启动 一 个 Hub 服务 ,等待 Node 进行 注册 和 请 求 
-hubConfig [filename] 设置 一 个 符合 Selenium Grid2 规则 的 json 格式 的 Hub 配置 文件 
DoR 指定 Hub 监听 的 端口 
-host ip 或 host, 指 定 Hub 机 的 ip 或 者 host 值 





指定 一 个 新 的 测试 session 等 待 执 行 的 间隔 时 间 , 即 一 个 代理 节点 上 前 后 两 
个 测试 间 的 时 间 间 隔 , 单 位 毫秒 。 默 认为 一 1, 即 没有 超时 。 
-browserTimeout 浏览 器 无 响应 的 超时 时 间 

-servlets xxx 在 Hub 上 注册 一 个 新 的 Servlet, 访 问 地 址 为 /grid/admin/xxx 


-newSession WaitTimeout 











作为 Node 节点 启动 时 部 分 参数 的 含义 如 表 14-2 所 示 。 








表 14-2 
参数 名 称 参数 含义 
-port 节点 计算 机 提供 远程 连接 服务 的 端口 号 ,也 是 Hub 监听 的 端口 





为 node 值 时 表示 注册 的 RC 可 以 支持 所 有 版 本 的 Selenium 
-role [node|wd|re] | Jy wd 值 时 表示 注册 的 RC 不 支持 Selenium! ,也 可 以 写成 webdriver。 
为 rc 值 时 表示 注册 的 RC 仅 支 持 Seleniuml 





url to. hubz 值 为 Hub 启动 的 注册 地 址 .默认 为 http://hub_ip: 4444/grid/ 


-hub url to hub ; 
register, 该 选项 包含 了 -hubHost 和 -hubPort 两 个 选项 





Hub 在 无 法 收 到 Node 节点 的 任何 请 求 后 ,在 等 待 timeout 设 定 的 时 间 后 会 自动 
-timeout 释放 和 Node 节点 的 连接 。 
注意 : 此 参数 不 是 WebDriver 定位 页 面 元 素 最 大 的 等 待 时间 
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e 
ET 
参数 名 称 参数 含义 
-maxSession 在 一 台 节 点 计算 机 中 ,允许 同时 最 多 打开 多 少 个 浏览 器 窗口 
设 定 节点 计算 机 允许 使 用 的 浏览 器 信息 ,例如 : 
browserName = firefox. version = 3. 6. firefox _ binary =/home/myhomedir/ 
firefox36/ firefox. maxInstances— 3. platform = LINUX 
version; 设 定 浏览 器 版 本 号 , 当 多 个 版 本 号 共存 的 时 候 , 要 明确 使 用 哪个 版 本 进 
-browser 行 测试 。 
platform; 设 定 节点 操作 系统 属性 为 Linux。 可 使 用 的 值 有 Windows, Linux 
和 Mac。 


firefox_binary: 设 定 Firefox 浏览 器 启动 路 径 。 
maxlInstances: 最 多 允许 同时 启动 3 个 Firefox 浏览 器 窗口 
设 定 节点 计算 机 间隔 多 少 毫秒 去 注册 一 下 Hub 管理 中 心 ,以 便 重启 Hub 时 不 





-registerCycle 

















需要 再 重新 启动 所 有 的 代理 节点 
-browserTimeout 浏览 器 无 响应 的 超时 时 间 
-nodeTimeout 客户 端 超时 时 间 
-cleanupCycle 代理 节点 检查 超时 的 周期 
-nodeConfig jsonFile | 一 个 符合 Selenium Grid2 规则 的 json 格式 的 Node 配置 文件 
-proxy 代理 类 默认 指向 org. openqa. grid. selenium. proxy. DefaultRemoteProxy 








-browserTimeout 浏览 器 无 响应 的 超时 时 间 


14.3.2. 远程 调用 IE 浏览 器 进行 自动 化 测试 

远程 调用 IE 浏览 器 进行 自动 化 测试 的 步骤 和 远程 调用 Firefox 浏览 器 的 步骤 基本 相 
同 ,只 是 节点 注册 Hub 的 命令 行 参数 和 测试 程序 有 一 些 变化 。 

操作 步骤 : 

CD 在 机 器 A 上 启动 Hub, 切 换 CMD 当前 工作 目录 到 selenium-server-standalone-3. 
0. 1. jar 文件 所 在 目录 ,然后 执行 如 下 命令 : 


java - jar selenium - server - standalone - 3. 0. 1. jar - role hub 


(2) 在 机 器 B 上 进行 Node 节点 注册 ,切换 CMD 当前 工作 目录 到 selenium-server- 
standalone-3. 0. 1. jar 文件 所 在 目录 ,然后 执行 如 下 命令 : 

java - jar selenium - server - standalone -3.0.1.jar - role webdriver - hub http://192.168.1. 

107:4444/grid/register — Dwebdriver. ie. driver = " C: V IEDriverServer. exe" - port 6655 — 

maxSession 5 - browser browserName = "internet explorer",maxInstances = 5 

与 Firefox 浏览 器 相 比 ,启动 Node 节点 Hub 服务 的 命令 只 需要 将 浏览 器 名 Firefox f£ 
改 成 Internet Explorer. 浏览 器 驱动 路 径 及 名 C: N geckodriver. exe 修改 为 C: \ 
IEDriverServer. exe 即 可 。 

测试 程序 : 

# encoding = utf - 8 


from selenium import webdriver 
from selenium. webdriver. common. keys import Keys 
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import time 


driver - webdriver.Remote( 
* BE Node 节点 的 URL Jb hE , ci ERE iE Uo] it f JE BE SE BEI Node 计算 机 
command executor = 'http://192.168.1.113:6655/wd/hub', 
desired capabilities - ( 
# TEE EA ORAT EH K A EU IE 
# ie8 以 下 版 本 写 ie, ie8 *j iehta, iell Ẹ internet explorer 
"browserName" : "internet explorer", 
"video": "True", 
# 远程 计算 机 的 平台 
"platform": "WINDOWS" # 或 者 写 XP 
) 
print ("Video: ”+ "http://www. baidu. com" + driver.session id) 


try: 
driver. implicitly wait(30) 
driver.maximize window() 
driver. get("http://www. sogou. con" ) 
assert u" 搜 狗 " in driver. title 
elem - driver.find element by id("query") 
elem. send keys(u"webdriver 实战 宝典 ") 
elem.send keys(Keys. RETURN) 
time. sleep(3) 
assert u" RRE" in driver.page source 
print 'done!' 

finally: 
driver.quit() 


14.3.3 ”远程 调用 Chrome 浏览 器 进行 自动 化 测试 


远程 调用 Chrome 浏览 器 进行 自动 化 测试 的 步骤 和 远程 调用 Firefox 浏览 器 的 步骤 基 
本 相同 ,只 是 节点 注册 Hub 的 命令 行 参数 和 测试 程序 有 一 些 变 化 。 

操作 步骤 : 

(1) 在 机 器 A 上 启动 Hub ,切换 CMD 当前 工作 目录 到 selenium-server-standalone-3. 
0.1.jar 文 件 所 在 目录 ,然后 执行 如 下 命令 : 


java - jar selenium - server - standalone - 3.0.1.jar - role hub 


(2) 在 机 器 B. 上 进行 Node( 节 点 ) 注 册 , 切 换 CMD 当前 工作 目录 到 selenium-server- 
standalone-3. 0. 1. jar 文件 所 在 目录 ,然后 执行 如 下 命令 : 


java - jar selenium - server - standalone - 3. 0. 1. jar - role webdriver - hub http://192.168.1. 
107:4444/grid/register — Dwebdriver. chrome. driver = "C: Vchromedriver. exe" — port 8855 一 
maxSession 5 — browser browserName = "chrome", maxInstances = 5 


测试 脚本 : 


#encoding= utf - 8 
from selenium import webdriver 
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from selenium. webdriver. common. keys import Keys 


import time 


driver = webdriver.Remote( 
* BE Node 节点 的 URL Jb hb , ci ERE iE D Te] it f JE BERE BEI Node 计算 机 
command executor - 'http://192.168.1.113:8855/wd/hub', 
desired capabilities = { 
# TEER ORAT EHK NE SEX chrome 
"browserName" : "chrome", 
"video" : "True", 
BoyxEIHEHHT A 
"platform": "WINDOWS" # 或 者 写 XP 
) 
print ("Video: " + "http://www. baidu. com" + driver. session_id) 


try: 
driver. implicitly wait(30) 
driver.maximize window() 
driver. get("http://www. sogou. con" ) 
assert u"jE Jg" in driver. title 
elem - driver.find element by id("query") 
elen.send keys(u"webdriver 实战 宝典 ") 
elem.send keys(Keys. RETURN) 
time. sleep(3) 
assert u" 吴 晓 华 " in driver.page source 
print 'done!' 

finally: 
driver.quit() 


14.3.4. 同时 支持 多 个 浏览 器 进行 自动 化 测试 


Selenium Grid 支持 同时 将 Node 节点 计算 机 上 多 个 浏览 器 注册 到 Hub 上 ,以 便 满 足 测 
试 过 程 中 对 不 同 浏览 器 的 需求 。 

操作 步骤 : 

CD 在 机 器 A 上 启动 Hub ,切换 CMD 当前 工作 目录 到 seleniunrserverstandalone-3. 0. 1. jar 
文件 所 在 目录 ,然后 执行 如 下 命令 : 


java - jar selenium - server - standalone - 3. 0. 1. jar - role hub 


(2) 在 机 器 B 上 进行 Node( 节 点 ) 注 册 , 切 换 CMD 当前 工作 目录 到 selenium-server- 
standalone-3. 0. 1. jar 文件 所 在 目录 ,然后 执行 如 下 命令 : 


java - jar selenium - server - standalone - 3. 0. 1. jar - role webdriver - hub http://192.168.1. 
107:4444/grid/register - Dwebdriver. chrome. driver = "C: \ chromedriver. exe" — Dwebdriver. ie. 
driver = "C: V IEDriverServer. exe" — Dwebdriver. firefox. driver = "C: V geckodriver. exe" - port 
6666 — maxSession 5 - browser browserName = "internet explorer", maxInstances = 5 - browser 


browserName = "chrome",maxInstances = 5 — browser browserName = "firefox", maxInstance = 5 
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测试 脚本 : 


# encoding =utf -8 

from selenium import webdriver 

from selenium. webdriver. common. keys import Keys 
import time, random 


# 芒 点 主机 的 访问 地 址 
host = "http://192.168.1.113:6666/wd/hub" 
browsers = ["firefox", "chrome", "internet explorer"] 
driver = webdriver.Remote( 
# BE Node 节点 的 URL Jb fib, ci HERE B DEVI To] Cf JE EIE BE] Node 计算 机 
command executor - host, 
desired capabilities - ( 
£ 在 browsers JI e rh bf BL vt FE— f DU VE d 
"browserName" : random. choice(browsers), 
"platform" : "WINDOWS" 
) 


try: 
driver. implicitly wait(30) 
driver.maximize window() 
driver. get(" http://www. sogou. con" ) 
assert u" 搜 狗 " in driver. title 
elem - driver.find element by id("query") 
elem.send keys(u"webdriver 实战 宝典 ") 
elem.send keys(Keys. RETURN) 
time. sleep(3) 
assert u" RRE" in driver.page source 
print 'done!' 

finally: 
driver.quit() 
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分 布 式 自动 化 测试 


操作 步骤 : 

CD 在 机 器 A 和 B 的 C 盘 根 目录 下 均 放 入 selenium-server-standalone-xx. xx. xx. jar 文件 。 

(2) 在 机 器 A 中 打开 CMD, 并 将 CMD 当前 工作 目录 切换 到 C 盘 根 目录 ,然后 执行 如 
下 命令 启动 Hub 服务 : 


java - jar selenium - server - standalone - 3. 0. 1. jar - role hub 
G) 在 机 器 B 中 打开 CMD, 并 将 CMD 当前 工作 目录 切换 到 C 盘 根 目录 , 然 后 执行 如 
下 命令 启动 机 器 B 节点 服务 ,并 进行 注册 : 


java - jar selenium - server- standalone ~ 3.0.1. jar — role webdriver - hub http://192.168.1. 
107:4444/grid/register — Dwebdriver. firefox. driver = "C: V geckodriver. exe" - port 6655 - 
maxSession 5 — browser browserName = "firefox", firefox binary = "C:\Program Files\Mozilla 
Firefox Vf irefox. exe", platform = "WINDOWS" , naxInstances = 5 
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上 述 命令 中 -browser 参数 后 面 的 值 均 是 本 次 远程 调用 的 Firefox 浏览 器 的 属性 ,其 中 
firefox binary 用 于 设置 浏览 器 的 安装 路 径 。 
测试 脚本 : 


# encoding = utf - 8 
from selenium import webdriver 





from selenium. webdriver.common.keys import Keys 
import unittest, time 
from HTMLTestRunner import HTMLTestRunner 


class SeleniunGridTest (unittest. TestCase) : 
def setUp(self): 
self.driver = webdriver.Remote( 
4 BE Node 节点 的 URL Jb hib , ci ERE B SEV o] ix f JE EIE BEI Node 计算 机 
command executor = 'http://192.168.1.113:6655/wd/hub', 
desired capabilities - ( 
E TEWE EX Firefox 
"browserName" : "firefox", 
"video": "True", 
"platform": "WINDOWS" 


) 
self.driver. implicitly wait(30) 
print ("Video: " + "http://www.baidu.com" + self.driver.session id) 


def testSogou(self): 
self.driver.maximize window() 
self.driver.get("http: //www. sogou. com" ) 
assert u' jg Jg" in self.driver.title 
elem = self. driver. find element by id("query") 
elen.send keys(u"webdriver 实战 宝典 " ) 
elen.send keys(Keys. RETURN) 
time. sleep(3) 
assert u" 吴 晓 华 " in self.driver.page source 
print 'done! ' 


def tearDown(self): 
self.driver.quit() 


def suite(): 
suitel = unittest. TestLoader(). loadTestsFronTestCase(SeleniumGridTest) 
return unittest. TestSuite(suitel) 


def run(suite, report = "d: WseleniumGridTest. html"): 
# 以 二 进 制 方式 采 开 文件 ,准备 写 
with open(report, "wb") as fp: 
# 使 用 HIMLTestRunner 配置 参数 , 48 TU BEES IRERE LUE, 0T A E 
runner - HTMLTestRunner( 
stream - fp, 
verbosity -2, 




















第 14 章 Selenium Grid 的 使 (C 


title = u' 分 布 式 测试 结果 '， 
description = u' 测 试 报告 描述 ') 
runner.run(suite) # 运行 测试 集 侣 


if name == ' main ': 
run(suite()) # 送行 测试 集合 


执行 结束 后 生成 的 测试 报告 如 图 14-19 所 示 。 


分 布 式 测试 结果 

Start Time: 2017-01-02 22:08:02 
Duration: 0:00:10.104000 
Status: Pass 1 


mitigi 


Show Summary Failed All 








Test Group/Test case Count 

|  testSogou pass 

[rotat E n lo lo I 
图 14-19 


14.5 SE S Apo: o pss 





Selenium Grid 不 仅 支 持 在 同一 台 机 器 上 同时 启动 好 几 个 浏览 器 并 发 跑 测 试用 例 , 也 支 
持 同时 在 多 台 不 同 机 器 上 启动 不 同 的 浏览 器 并 发 跑 测 试用 例 , 本 节 主 要 针对 第 二 种 方法 进 
行 讲解 。 

操作 步骤 : 

CD 在 机 器 A,B AI C f C 盘 根 目录 放 入 selenium-server-standalone-xx. xx. xx. jar 


文件 。 
(2) 在 机 器 A 中 打开 CMD. 并 将 CMD 当前 工作 目录 切换 到 C 盘 根 目录 ,然后 执行 如 


下 命令 启动 Hub 服务 : 

java - jar selenium - server - standalone — 3. 0. 1. jar - role hub 

再 重新 打开 一 个 CMD, 将 CMD 当前 工作 目录 切换 到 C 盘 根 目录 ,然后 执行 如 下 命令 
进行 节点 注册 : 


java - jar selenium - server - standalone - 3. 0. 1. jar - role webdriver - hub http://192. 168. 
31.26:4444/grid/register — Dwebdriver. ie. driver = "C: V IEDriverServer. exe" - port 6655 — 
maxSession 5 - browser browserName - "internet explorer",maxInstances - 5 


G) 在 机 器 B 中 打开 CMD. 并 将 CMD 当前 工作 目录 切换 到 C 盘 根 目录 ,然后 执行 如 
下 命令 启动 机 器 B 节点 服务 ,并 进行 注册 : 


java — jar selenium - server - standalone - 3. 0. 1. jar - role webdriver — hub http://192.168. 
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31.26:4444/grid/register - Dwebdriver. firefox. driver = "C:\geckodriver. exe" — port 6666 一 
maxSession 5 — browser browserName = "firefox",platform = "WINDOWS", maxInstances = 5 


CD 在 机 器 C 中 打开 CMD ,并 将 CMD 当前 工作 目录 切换 到 C 盘 根 目录 ,然后 执行 如 
下 命令 启动 机 器 B 节点 服务 ,并 进行 注册 : 


java - jar selenium - server - standalone - 3.0.1. jar - role webdriver - hub http://192. 168. 
32.26:4444/grid/register - Dwebdriver. chrome. driver = "C: XV chromedriver. exe" — port 8889 — 
maxSession 5 - browser browserName = "chrome", platform = "WINDOWS" ,maxInstances = 5 


注册 的 AB 和 C 机 器 节点 的 端口 号 必须 不 一 致 。 


测试 脚本 : 


#encoding= utf - 8 

from multiprocessing import Pool 

import os, time 

from selenium import webdriver 

from selenium. webdriver. common. keys import Keys 
from multiprocessing import Manager, current process 


def node task(name, lock, arg, successTestCases, failTestCases): 
# KG AEE 
procName = current process().name 
print procName 
tine. sleep(1.2) 
print arg[ 'node' ] 
print arg[" browerNanme" ] 
print 'Run task %s (5 s)...WVn' % (name, os.getpid()) 
start = time. time() 
driver = webdriver.Remote( 
command executor = " % s" *arg['node'], 
desired capabilities= { 
"browserName": " % s" %arg["browerName" ], 
"video": "True", 
"platform" : "WINDOWS" } ) 
try: 
driver. implicitly wait(30) 
driver.maximize window() 
driver. get(" http://www. sogou. con" ) 
assert u" į Jg" in driver.title 
elem = driver.find element by id("query") 
elem.send keys(u"webdriver 实战 宝典 " ) 
time. sleep(2) 
elem.send keys(Keys. RETURN) 
assert u" & BE SÉ" not in driver.page source 
E RRE VEIBÍ BR 
lock.acquire() 
# KARHE successTestCases H E HART II BO HH 4 Fe 
successTestCases. append("TestCase" + str(nane)) 
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# PERHE DEWR AY i, 以便 其 他 进程 能 获取 到 此 锁 
lock.release() 
print"TestCase" + str(name) + " done!" 
except AssertionError, e: 
print "AssertionError occur!""testCase" * str(name) 
print e 
# 截取 屏幕 
driver. save_screenshot('d:\\screenshoterror' + str(name) + '.png') 
lock.acquire() 
# 向 共享 列表 failTestCases (his MHITA WD JH IPIE ER 
failTestCases.append("TestCase" * str(name)) 
lock.release() 
print u" 测试 用 例 执 行 失败 " 
except Exception,e: 
print "Exception occur!" 
print e 
driver.save screenshot('d:VVscreenshoterror' + str(name) + '.png') 
# OR ER JESE VERB EDU BI HNES H SIRO 
with lock: 
# 向 共享 列表 failTestCases 由 添加 执行 失败 的 用 陪 名 称 
failTestCases.append("TestCase" * str(name) ) 
print u" 测 试用 例 执行 失败 ” 
finally: 
driver. quit() 
end = time. time() 
print 'Task % s runs %0.2f seconds.' % (name, (end - start)) 


def run(nodeSeq): 
* 创建 一 个 多 进程 的 Manager 实例 
manager = Manager() 
# 定义 一 个 共享 资源 列表 successTestCases 
successTestCases = manager.list([]) 
# EX MIE AE failTestcases 
failTestCases = manager. list([]) 
# 创建 一 个 资源 锁 
lock = manager.Lock() 
# TÜLESERM EE ID 
print 'Parent process $ s.' * os.getpid() 
# 创建 一 个 容重 为 3 的 进程 池 
p = Pool(processes = 3) 
testCaseNumber - len(nodeSeq) 
for i in range(testCaseNumber) : 
# 循环 创建 子 进程 ,并 将 需要 的 数据 传人 于 进程 
p.apply async(node task, args- (i + 1, lock, nodeSeq[i], 
successTestCases, failTestCases)) 
print 'Waiting for all subprocesses done..." 
# 关闭 进程 洱 ,不 再 接受 新 的 请 下 任务 
p. close() 
# MEEA HPT ERR 
p. join() 
return successTestCases, failTestCases 
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def resultReport(testCaseNumber, successTestCases, failTestCases): 
# OFICPEHIT TIBIAE KH EGRE 
print u" 测试 报告 :\n" 
print u" 共 执行 测试 用 例 :" + str(testCaseNumber) + un 个 \n" 
print u" 成 功 的 测试 用 例 :"，str(len(successTestCases)) 
if len(successTestCases) > 0: 
for t in successTestCases: 
print t 
else: 
print um 无" 
print u" 失 败 的 测试 用 例 :" ，str(len(failTestCases)) 
if len(failTestCases) > 0: 
for t in failTestCases: 
print t 
else: 
print u" 无 ” 
if name  -- ' main ': 
# PAIK 
nodeList = [ 
(" node" :" http: //10.0.24.206:6666/wd/hub" , " browerName" :" internet explorer" }, 
(" node" :" http: //10. 0.24. 206: 6666/wd/hub" , " browerNane" :" chrome" }, 
(" node" :" http: //10.0.24.206:6666/wd/hub" , " browerNane" :"£irefox"]] 
# 获取 芳 点 个 数 
testCaseNumber = len(nodeList) 
# PISA EB CO C 
successTestCases, failTestCases - run(nodeList) 
print 'All subprocesses done. ' 
# teteh A PITE WIR E 


resultReport(testCaseNumber, successTestCases, failTestCases) 
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本 章 为 高 级 自动 化 工程 师 的 必 备 技能 ,也 是 本 书 最 具 吸 引力 的 一 章 。 本 章 将 从 零 开 始 
搭建 一 个 完整 的 自动 化 测试 框架 ,请 立志 成 为 高 级 自动 化 测试 专家 的 读者 仔细 阅读 ,建议 参 
照 本 章 的 内 容 在 本 地 计算 机 环境 中 进行 搭建 实战 。 笔 者 认为 ,只 有 不 断 地 实践 ,才能 真正 具 
备 自动 化 测试 框架 的 搭建 能 力 。 


15.1 WELA SEES 


大 多 数 的 测试 从 业者 都 是 从 手工 测试 开始 自己 的 职业 生涯 的 ,经 过 多 年 的 手工 测试 后 ， 
开始 思考 自己 的 未 来 发 展 之 路 ,难道 要 一 辈子 靠 手 工 的 方式 来 完成 测试 吗 ” 一 些 手工 测试 
工程 师 开 始 尝试 使 用 自动 化 测试 工具 来 蔡 代 执行 自己 每 天 不 断 重复 的 手工 测试 过 程 。 但 是 
在 执行 过 程 中 ,他 们 会 发 现 好 不 容易 写 好 的 测试 脚本 ,因为 需求 变化 的 原因 没 过 多 久 就 无 法 
顺利 执行 了 。 这 样 的 情况 在 软件 开发 过 程 中 是 不 可 避免 的 ,测试 工程 师 只 能 去 不 断 修改 和 
维护 自动 化 测试 脚本 。 但 是 没 过 多 长 时 间 , 被 测试 软件 的 需求 又 发 生 了 或 多 或 少 的 变化 或 
调整 ,导致 原 有 的 自动 化 测试 脚本 又 无 法 运行 了 。 这 样 的 情况 反复 出 现 后 ,测试 工程 师 发 现 
投入 维护 脚本 的 时 间 和 精力 比 纯 手 工 测试 的 方式 还 要 多 ,而 且 还 造成 手工 测试 的 时 间 被 明 
显 减 少 ,导致 测试 的 效果 大 打折 扣 , 软 件 的 质量 还 不 如 以 前 纯 手工 测试 的 时 候 好 。 有 的 时 候 
测试 脚本 刚刚 修改 一 半 ,软件 的 需求 又 发 生 了 变化 ,这 样 的 情况 导致 测试 工程 师 只 能 放弃 自 
动 化 测试 脚本 的 维护 ,被 迫 重新 投入 到 手工 测试 中 。 

以 上 场景 大 量 地 出 现在 各 个 尝试 自动 化 测试 的 公司 中 ,大 家 也 在 思考 和 尝试 解决 这 样 
的 问题 , 如 何 能 够 降低 测试 脚本 的 维护 成 本 和 工作 量 , 提 高 自动 化 测试 脚本 的 编写 和 维护 
效率 ,真正 让 自动 化 测试 能 够 提高 软件 测试 工程 师 的 工作 效率 ,为 企业 真正 节省 测试 成 本 ， 
能 够 为 开发 团队 快速 地 反馈 当前 软件 质量 状态 ?在 这 样 的 历史 时 期 ,自动 化 测试 框架 应 运 
而 生 。 

1. 自动 化 测试 框架 概述 

自动 化 测试 框架 是 应 用 于 自动 化 测试 的 程序 框架 , 它 提供 了 可 重用 的 自动 化 测试 模块 ， 
提供 最 基础 的 自动 化 测试 功能 (例如 ,打开 浏览 器 、 单 击 链接 等 功能 ) ,或 提供 自动 化 测试 执 
行 和 管理 功能 的 架构 模块 (例如 TestrNG)。 它 是 由 一 个 或 多 个 自动 化 测试 基础 模块 、 自 动 
化 测试 管理 模块 .自动 化 测试 统计 模块 等 组 成 的 工具 集合 。 

2. 自动 化 测试 框架 常见 的 4 种 模式 

CD 数据 驱动 测试 框架 

使 用 数据 数组 测试 数据 文件 或 者 数据 库 等 方式 作为 测试 过 程 输入 的 自动 化 测试 框架 ， 
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此 框架 可 以 将 所 有 测试 数据 在 自动 化 测试 执行 的 过 程 中 进行 自动 加 载 ,动态 判断 测试 结果 
是 否 符合 预期 ,并 自动 输出 测试 报告 。 

此 框架 一 般 用 于 在 一 个 测试 流程 中 使 用 多 组 不 同 的 测试 数据 ,以 此 来 验证 被 测试 系统 
是 否 能 够 正常 工作 。 

(2) 关键 字 驱 动 测试 框架 

关键 字 驱 动 测试 框架 可 以 理解 为 高 级 的 数据 驱动 测试 框架 ,使 用 被 操作 的 元 素 对 象 . 操 
作 的 方法 和 操作 的 数据 值 作为 测试 过 程 输入 的 自动 化 测试 框架 ,简单 表示 为 item. 
operationCvalue) 。 被 操作 的 元 素 对 象 .操作 的 方法 和 操作 的 数据 值 可 以 保存 在 数据 数组 、 
数据 文件 ,数据 库 中 作为 关键 字 驱 动 测试 框架 的 输入 。 例 如 在 页 面 上 的 用 户 名 输入 框 中 输 
入 用 户 名 , 则 可 以 在 数据 文件 中 进行 如 下 定义 : 

用 户 名 输入 框 ,输入 , testman 


关键 字 驱 动 测 试 框架 属于 更 加 高 级 的 自动 化 测试 框架 ,可 以 兼容 更 多 的 自动 化 测试 操 
作 类 型 ,大 大 提高 了 自动 化 测试 框架 的 使 用 灵活 性 。 

(3) 混合 型 测试 框架 

在 关键 字 驱 动 测试 框架 中 加 入 了 数据 驱动 的 功能 , 则 框架 被 定义 为 混合 型 测试 。 

(4) 行为 驱动 测试 框架 

支持 自然 语言 作为 测试 用 例 描述 的 自动 化 测试 框架 ,例如 前 面 章节 讲 到 的 lettuce 

3. 自动 化 测试 框架 的 作用 

(1) 能 够 有 效 组 织 和 管理 测试 脚本 。 

(2) 进行 数据 驱动 或 者 关键 字 驱 动 的 测试 。 

(3) 将 基础 的 测试 代码 进行 封装 ,降低 测试 脚本 编写 的 复杂 性 和 重复 性 。 

(4) 提高 测试 脚本 维护 和 修改 的 效率 。 

(5) 自动 执行 测试 脚本 ,并 自动 发 布 测试 报告 ,为 持续 集成 的 开发 方式 提供 脚本 支持 。 

(6) 让 不 具备 编程 能 力 的 测试 工程 师 开 展 自 动 化 测试 工作 。 

4. 自动 化 测试 框架 的 设计 核心 思想 

世上 没有 最 好 的 自动 化 测试 框架 ,也 没有 万 能 的 自动 化 测试 框架 ,各 种 自动 化 测试 框架 
都 有 自身 的 优点 和 缺点 ,所 以 我 们 在 设计 自动 化 测试 框架 的 时 候 要 考虑 到 实现 一 套 自 动 化 
测试 框架 到 底 能 够 为 测试 工作 本 身 解 决 什么 样 的 具体 问题 ,不 能 为 了 自动 化 而 自动 化 ,我 们 
要 以 解决 测试 中 的 问题 和 提高 测试 工作 的 效率 为 主要 导向 来 进行 自动 化 测试 框架 的 设计 。 

自动 化 测试 框架 的 核心 思想 是 将 常用 的 脚本 代码 或 者 测试 逻辑 进行 抽象 和 总 结 ,然后 
将 这 些 代码 进行 面向 对 象 设计 .将 需要 复 用 的 代码 封装 到 可 公用 的 类 方法 中 。 通 过 调用 公 
用 的 类 方法 ,测试 类 中 的 脚本 复杂 度 会 被 大 大 降低 :让 更 多 脚本 能 力 不 强 的 测试 人 员 来 实施 
自动 化 测试 。 

创建 和 实施 Web 自动 化 测试 框架 的 步骤 如 下 : 

COD 根据 测试 业务 的 手工 测试 用 例 , 选 出 需要 可 自动 化 执行 的 测试 用 例 。 

(2) 根据 可 自动 化 执行 的 测试 用 例 , 分 析出 测试 框架 需要 模拟 的 手工 操作 和 重复 高 的 
测试 流程 或 逻辑 。 
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(3) 将 手工 操作 和 重复 高 的 测试 逻辑 用 在 代码 中 实现 ,并 在 类 中 进行 封装 方法 的 编写 。 

CD 根据 测试 业务 的 类 型 和 本 身 技术 能 力 , 选 择 数据 驱动 框架 、 关 键 字 驱 动 框架 、 混 合 
型 框架 还 是 行为 驱动 框架 。 

(5) 确定 框架 模型 后 ,将 框架 中 常用 的 浏览 器 选择 ,测试 数据 处 理 、 文 件 操作 数据 库 操 
作 、 页 面 元 素 的 原始 操作 日 志和 报告 等 功能 进行 类 方法 的 封装 实现 。 

(6) 对 框架 代码 进行 集成 测试 和 系统 测试 ,采用 PageObject 模式 和 TestNG 框架 (或 
JUnit) 编 写 测试 脚本 ,使 用 框架 进行 自动 化 测试 ,验证 框架 的 功能 可 以 满足 自动 化 测试 的 

(7) 编写 自动 化 测试 框架 的 常用 API 文 档 , 以 供 他 人 参阅 。 

(8) 在 测试 组 内 部 进行 培训 和 推广 。 

(9) 不 断 收集 测试 过 程 中 的 框架 使 用 问题 和 反馈 意见 ,不 断 增加 和 优化 自动 化 框架 的 
功能 ,不 断 增 强 框 架 中 复杂 操作 的 封装 效果 ,尽量 降低 测试 脚本 的 编写 复杂 性 。 

(10) 定期 评估 测试 框架 的 使 用 效果 ,评估 自动 化 测试 的 投入 产 出 比 ,再 逐步 推广 自动 
化 框架 的 应 用 范围 。 


15.2 MESECEEUEEE PIE HESS 


本 节 主 要 讲解 数据 驱动 测试 框架 的 搭建 ,并 且 使 用 此 框架 来 测试 126 邮箱 登录 和 地 址 
夭 的 相关 功能 。 框 架 用 到 的 基础 知识 均 在 前 面 的 章节 中 做 了 详细 介绍 ,本 节 重 点 讲解 框架 
搭建 的 详细 过 程 。 

被 测试 功能 的 相关 页 面 描述 : 

登录 页 面 如 图 15-1 所 示 。 登 录 后 的 页 面 如 图 15-2 所 示 。 
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rA 
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149 Lu 01152 @l26com 
Ee 密码 输入 框 _ 
立即 抢 >> < 5 
xem sesa 


EIB - 


menus AER Tc Ellas nm 


加 推荐 邮箱 它 方 APP [ cnn 
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wangchenxin， 放 下 担子 ， 过 随遇而安 的 生活 ! 
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> 其 他 3 个 文件 突 内 容 ， 用 于 判断 是 否 登录 
pu 成 功 
Maro z 
文件 中 心 
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图 15-2 


单 击 “ 通 讯 录 ” 链 接 后 ,进入 通讯 录 主页 ,如 图 15-3 所 示 。 





图 15-3 


在 图 15-3 所 示 的 “新 建 联系 人 ?对 话 框 中 ,输入 联系 人 的 基本 信息 ,然后 单 击 “ 确 定 ? 按 
钮 保存 ,显示 的 页 面 如 图 15-4 所 示 。 

非 数 据 驱 动 框架 时 的 添加 邮箱 联系 人 自动 化 测试 代码 : 

# encoding- utf - 8 


from selenium import webdriver 
from selenium. webdriver.common.keys import Keys 
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EEA EXE | ss ses | ns- LARA 


所 有 联系 人 QD) g sa mar ci FENE 
HEREA (1) " = zhangsan@s0g.. 14900000001 
pss o 
E - fæl BUE dPEREDAONE E , 1833 AIO 22 EURIDORLADIE ! 
"- 4 3. ] 设 为 星 标 联系 人 后 ， 该 联系 人 将 添加 至 收 件 第 的 左 锋 栏 ， 可 以 很 方便 的 查看 由 | 
A 左 饥 刁 的 联系 组 也 可 以 设 为 野 标 联系 组 万 ! 
图 15-4 
import time 


# 创建 Chrome DU VE d hY Si: fn] 

driver = webdriver.Chrome(executable path = "c: W chromedriver") 
# BEBE BRIX 108 

driver. implicitly wait(10) 

# dRe KIEN E SE B 


driver.maximize window() 


# 访问 126 邮箱 登录 页 面 

driver, get("http://mail.126. com") 

# WE Sb, PUB IS VER DT TET D AC C 

time. sleep(5) 

# Ut frane fff 

driver.switch to.frame("x- URS - iframe") 

# GXOIUILP 4 ii A E 

userName = driver.find element by xpath('//input[(2name = "email"]') 
# 得 人 用 户 名 

userName. send keys(" xxx" ) 

# Kii A E 

pwd = driver. find element by xpath(" //input[(name = 'password']") 
# MAR 

pwd. send keys(" xxx" ) 

# Ruk—4 pn 4f 

pwd. send keys(Keys. RETURN) 


# GIF 10 Fb, DUAE EE TAR D 5 HD TT II TI CC R 
time. sleep(10) 
# ud "lo ERU 
driver.find element by xpath("//div[text() = ' 通 讯 录 ']" ).click() 
time. sleep(2) 
# qd "WEE RA UB 
driver.find element by xpath("//span[text() = ' 新 建 联 系 人 ']").click() 
time. sleep(2) 
# MARRAK 
driver.find element by xpath(V 
"//a[ (2 title- ' 编 辑 详细 姓名 ' ]/preceding - sibling::div/input"). send keys(u"lucy") 
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# MARRA ETA 

driver. find element by xpathV 

("// * [(Gid- 'iaddress MAIL wrap']//input").send keys(u"xxx(4qq. con" ) 

driver. find element by xpath("//span[text() = ' 设 为 星 标 联 系 人 ']/preceding - sibling: : span/ 

b").click() 

time. sleep(2) 

üBABURATNS 

driver.find element by xpathV 

("// * [@id= 'iaddress TEL wrap']//dd//input").send keys("135xxxxxxx") 

time. sleep(2) 

# MAREE 

driver.find element by xpath("//textarea").send keys(u" 朋 友 ") 

time. sleep(2) 

# 单 击 "确认 fei 

driver.find element by xpath("//span[text() = ' 确 定 ']").click() 

time. sleep(5) 

driver.quit() 

注意 在 执行 上 述 代码 前 ,请 将 代码 里 面 的 "xxx? 换 成 有 效 的 登录 用 户 名 及 密码 ,以 后 章 
节 也 是 如 此 ,就 不 再 歼 述 了 。 

本 节 要 做 的 事 就 是 将 上 面 的 程序 一 步 步 地 改 成 数据 驱动 测试 框架 。 

数据 驱动 框架 搭建 过 程 如 下 : 

(1) 在 PyCharm 工具 中 ,新 建 一 个 名 叫 DataDrivenFrameWork 的 Python 工程 。 

(2) 在 工程 中 新 建 4 个 Python Package, 分 别 命 53 DataDrivenFrameWork ) EappModul 
名 为 : foto -| Ow I|- 






Y D DataDrivenFrameWork DAP: 
f E3 appModules 


> appModules, 用 于 实现 可 复 用 的 业务 逻辑 封装 
方法 。 

> pageObjects, 用 于 实现 被 测试 对 象 的 页 面 对 象 。 

> testScripts, 用 于 实现 具体 的 测试 脚本 逮 辑 。 

> util ,用 于 实现 测试 过 程 中 调用 的 工具 类 方法 , 例 
如 读 取 配置 文件 .MapObject、 页 面 元 素 的 操作 方 
法 ,解析 Excel 文件 等 。 

详细 结构 图 如 图 15-5 Bron o 

G) 在 util 包 中 新 建 一 个 名 叫 ObjectMap. py 的 

Python 文件 ,用 于 实现 定位 页 面 元 素 的 公共 方法 ,具体 代码 如 下 s 














# encoding = utf - 8 
from selenium. webdriver. support. ui import WebDriverWait 


# OIX DU DC XXE 
def getElement(driver, locateType, locatorExpression): 
try: 
element - WebDriverWait(driver, 30).untilV 
(lambda x: x. find element(by = locateType, value = locatorExpression)) 
return element 
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except Exception, e: 


raise e 


# EHE TBI] VEI CREE, 以 list iR Io] 
def getElements(driver, locateType, locatorExpression): 
try: 
elements - WebDriverWait(driver, 30).untilV 
(lambda x:x.find elements(by = locateType, value = locatorExpression)) 
return elenents 
except Exception, e: 
raise e 


if nane  -- ' main ': 

from selenium import webdriver 

# 进行 单元 测试 

driver = webdriver.Firefox(executable path="c:\geckodriver. exe" ) 
driver. get("http:/ /www. baidu. con" ) 

searchBox - getElement(driver, "id", "kw") 
# ITRE IR I s ER 

print searchBox.tag name 

aList - getElements(driver, "tag name", "a") 
print len(aList) 

driver.quit() 


以 上 代码 的 含义 请 参阅 之 前 章节 的 讲解 。 
(4) 在 pageObjects 包 中 新 建 一 个 名 叫 LoginPage. py 的 Python 文件 ,用 于 编写 126 邮 
箱 登录 页 面 的 页 面 元 素 对 象 ,具体 代码 如 下 : 


#encoding= utf - 8 
from util.ObjectMap import * 


class LoginPage(object): 


def init (self, driver): 
self.driver - driver 


def switchToFrame(self): 
self.driver. switch to.frame("x- URS - iframe") 


def suitchToDefaultFrame(self): 
self.driver. switch to.default content() 


def userNaneObj(self): 
try: 
# 获取 登录 页 面 的 用 户 名 输 人 奏 页 面 对 象 ,并 返回 给 凋 用 者 
elementObj = getElement(self.driver, 
"xpath", '//input[(Z name = "email"]') 
return elementObj 
except Exception, e: 
raise e 


s Selenium WebDriver 3.0 一 & zh 4X e 2e 3c 4 
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def passwordObj(self): 
try: 
# DIRE R JUI BO 87 3i A T T TRI e, HiB oL ELE E 
elementObj - getElement(self.driver, "xpath", 
" //input[ (2 name = 'password']") 
return elementObj 
except Exception, e: 


raise e 


def loginButton(self): 
try: 
# 获取 登录 页 面 的 登录 按 纪 页 面 对 象 ,并 返回 纷 调 用 者 
elementObj = getElement(self.driver, "id", "dologin") 
return elementObj 
except Exception, e: 
raise e 


if name  -- ' main ': 
# 测试 代码 
from selenium import webdriver 
driver = webdriver.Firefox(executable path = "c: Vgeckodriver. exe" ) 
driver. get("http://mail.126.com") 
import time 
tine. sleep(5) 
login = LoginPage(driver) 
driver.switch to.frame("x- URS - iframe") 
E 答 人 登录 用 户 和 名 
login. userNameObj(). send keys(" xxx" ) 
# MARRE 
login. passwordObj(). send keys(" xxx" ) 
login. loginButton().click() 
login. switchToDefaultFrame() 
driver.quit() 


(5) 在 testScripts 包 中 新 建 一 名 叫 TestMaill26 AddContacts, py 的 Python 文件 ,用 于 
编写 具体 的 测试 操作 代码 ,具体 代码 如 下 : 


# encoding = utf - 8 

from selenium import webdriver 

from pageObjects. LoginPage import LoginPage 
import tine 


def testMailLogin(): 
try: 

£ 启动 Firefox Dil V 2 
driver = webdriver.Firefox(executable path = "c: Vgeckodriver. exe" ) 
# 访问 126 邮箱 首页 
driver. get ("http://mail. 126. com" ) 
driver. implicitly wait(30) 
driver.maximize window() 
loginPage - LoginPage(driver) 


: 310 * 
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A HEADE HHA SIE BLEU frame 中 ,以 便 能 进行 后 缕 登 录 操 作 

loginPage. switchToFrame() 

E 答 人 登录 用 户 名 

loginPage. userNameObj(). send keys(" xxx" ) 

# 得 人 登录 密码 

loginPage. passwordObj(). send keys(" xxx" ) 

# muwiet 

loginPage. loginButton().click() 

time.sleep(5) 

# UMASIEUA BH E, DUET Firefox W w dE 

loginPage. switchToDefaultFrame() 

assert u" i£ fF" in driver.page source 
except Exception, e: 

raise e 





finally: 
LEO 
driver.quit() 


if name  -- ' main ': 
testMailLogin() 
print u" 登 录 126 邮箱 成 功 !" 


上 述 代 码 虽然 分 了 模块 ,但 是 仍 未 做 到 程序 与 数据 的 分 离 ,不 能 实现 框架 的 通用 ,所 以 
我 们 需要 继续 进行 改造 。 

(6) 在 appModules 包 中 新 建 一 个 名 叫 LoginAction. py 的 Python 文件 ,实现 登录 模块 
的 封装 方法 ,具体 代码 如 下 : 


# encoding- utf - 8 
from pageObjects.LoginPage import  LoginPage 


class LoginAction(object): 
def init (self): 
print "login..." 


(à staticmethod 
def login(driver, username, password): 
try: 
login - LoginPage(driver) 
# 将 当前 焦点 切换 到 登录 模块 的 frame 中 , O (E REHITA EG R PEE 
login. switchToFrame( ) 
# 输 人 登录 用 户 和 名 
login. userNameObj( ). send keys(username) 
# MABRE 
login. passwordObj(). send keys(password) 
# 单 击 登 录 按钮 
login. loginButton().click() 
# WISI BI E 
login. switchToDefaultFrame() 
except Exception, e: 


raise e 


M- 
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if nane  -- ' main - 
from selenium import webdriver 

import time 

* 启动 Chrome j| w 4E 

driver = webdriver.Chrome(executable path-"c:W chromedriver") 


* 访问 126 邮箱 首页 

driver. get("http://mail. 126.com" ) 

time. sleep(5) 

LoginAction.login(driver, username = "xxx", password = "xxx" ) 
time. sleep(5) 


driver. quit() 
(7) 修改 testScripts 包 中 的 TestMaill26AddContacts. py 内 容 如 下 : 


# encoding - utf -8 

from selenium import webdriver 

from appModules.LoginAction import LoginAction 
import time 


def testMailLogin(): 
try: 
* 启动 Chrome ÑY W i 
driver = webdriver.Chrome(executable path = "c: WW chromedriver") 
# 访问 126 lf eH TT 
driver. get("http://mail. 126.com" ) 
driver. implicitly_wait(30) 
driver. maximize_window( ) 
time. sleep(5) 
# 登录 126 邮箱 
LoginAction. login(driver, "xxx", "xxx" ) 
time. sleep(8) 
assert u" 未 读 邮 件 " in driver.page source 
except Exception, e: 
raisee 
finally: 
driver.quit() 
if name  -- ' main ': 
testMaillogin() 
print u" 登 录 126 邮箱 成 功 !" 
比较 TestMaill26AddContacts. py 修改 前 后 的 代码 ,我 们 可 以 发 现 登 录 操 作 的 多 个 步 
又 被 一 个 函数 调用 替代 了 ,函数 为 LoginAction. login (driver. username = "xxx". 
password = “xxx")。 此 种 方式 实现 了 业务 馆 辑 的 封装 ,只 要 调用 一 个 函数 就 可 以 实现 全 
录 的 操作 ,大 大 减少 了 测试 脚本 的 重复 编写 ,从 而 也 实现 了 代码 的 封装 。 
(8) 在 DataDrivenFrameWork 工程 中 新 建 一 个 名 叫 config 的 Python Package, 并 在 
config 包 里 新 建 一 个 名 叫 PageElementLocator. ini 的 File, 用 于 配置 定位 页 面 元 素 的 定位 
表达 式 , 具 体内 容 如 下 : 


-I2 
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[126mail login] 
loginPage. frame - id» x - URS - iframe 

loginPage. username = xpath »//input[(Z name = 'email'] 
loginPage. password = xpath >//input[ (@name = 'password'] 
loginPage. loginbutton = id» dologin 


(9) 在 config 包 中 新 建 一 个 名 叫 VarConfig. py 的 Python 文件 ,此 文件 主要 用 于 定义 
一 些 全 局 变量 ,用 于 存储 一 些 文件 路 径 等 ,具体 内 容 如 下 : 


# encoding = utf -8 
import os 


# XH H RIEN TE A R KI In ERES 
parentDirPath = os.path.dirname(os.path.dirname(os.path.abspath( file _))) 


# DEFE BIBITUR AE KAE fF Y AB ERA EG 
pageElementLocatorPath = parentDirPath + u"\\config\\PageElementLocator. ini" 


(10) 在 util 包 中 新 建 一 个 名 叫 ParseConfigurationFile. py 的 Python 文件 ,用 于 解析 
存储 定位 页 面 元 素 的 定位 表达 式 文件 ,以 便 获取 定位 表达 式 , 具 体内 容 如 下 : 


#encoding= utf - 8 
from ConfigParser import ConfigParser 
from config.VarConfig import pageElementLocatorPath 


class ParseCof igFile(object): 


def _ init (self): 
self.cf - ConfigParser() 
self.cf.read(pageElementLocatorPath) 


def getItemsSection(self, sectionName): 
# 获取 配置 文件 中 指定 section 下 的 所 有 option 刍 什 对 
# 间 以 字典 类 型 返回 给 调用 者 
Ub: 
{EJH self.cf. items(sectionName) 此 种 方法 获取 到 的 
配置 文件 中 的 options PIE OPE RUNI, 
比如 , loginPage. frame Wt $£1& nè T loginpage. frame 
optionsDict - dict(self.cf. items(sectionName)) 
return optionsDict 


def getOptionValue(self, sectionName, optionName): 
# 获取 指定 section 下 的 指定 option 的 得 
value = self.cf.get(sectionName, optionName) 


return value 


if nane ==' main ': 
pc = ParseCofigFile() 
print pc.getltemsSection("126mail login") 


print pc.getOptionValue("126mail login", "loginPage. frame") 
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(11) 修改 pageObjects 包 中 的 LoginPage. py 文件 内 容 如 下 : 


#encoding = 
from util. Ob 
from util. Pa 


utf -8 
jectMap import 关 
rseConfigurationFile import ParseCofigFile 


class LoginPage(object): 


def _ init (self, driver): 
self.driver - driver 
self.parseCF - ParseCofigFile() 
self.loginOptions - self.parseCF.getltemsSection("126mail login") 
print self.loginOptions 


def switchToFrame(self): 


try 


# MEREEN FP EI frane 的 定位 表达 式 
locatorExpression = self.loginOptionsV 
[" loginPage. frame". lower()].split("»")[1] 
self.driver. switch to.frame(locatorExpression) 


except Exception, e: 


raise e 


def switchToDefaultFrame(self): 
try: 


self.driver.switch to.default content() 


except Exception, e: 


raise e 


def userNameObj( self): 
try: 


# MERE PIX EP BEHOE fi HIP ih A HER t fr Ir HIA C 
locateType, locatorExpression = self. loginOptionsV 

[" loginPage. username" . lower() ]. split("»") 
# DROZ RT MAF 8 Ae IBI Ge, JAB PLATE 
elementObj = getElement(self.driver, locateType, locatorExpression) 
return elementObj 


except Exception, e: 


raise e 


def passwordObj(self): 
try: 


# MERI PLC ME rh EROE (i SERM A BEI AE fr Ir HIE A C 
locateType, locatorExpression = self. loginOptionsV 

[" loginPage. password" . lower() ]. split("»") 
# DIR DC IU E R Ah A HETT II R, JR PLA ELTE 
elementObj = getElement(self.driver, locateType, locatorExpression) 
return elementObj 


except Exception, e: 


raise e 
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def loginButton( self) : 
try: 
# MERER A BI EP EEHUE T2 EE iE A KE 7p RMK 
locateType, locatorExpression = self. loginOptions\ 
[" loginPage. loginbutton" . lower ( ) ]. split("»") 
# CHOR I AYE GREC A T XI G, HFE lA AA 
elementObj = getElement(self.driver, locateType, locatorExpression) 
return elementObj 
except Exception, e: 
raise e 
if name  -- ' main ': 

# 测试 代码 

from selenium import webdriver 

driver = webdriver.Chrome(executable path="c:\\chromedriver") 

driver. get("http://mail.126.com") 

import time 

time. sleep(5) 

login = LoginPage(driver) 

login. switchToFrame() 

E 答 人 登录 用 户 各 

login. userNameObj(). send keys(" xxx" ) 

# MARRE 

login. passwordObj(). send keys(" xxx" ) 

login. loginButton().click() 

time.sleep(10) 

login. switchToDefaultFrame() 

assert u" 未 读 邮 件 " in driver.page source 

driver.quit() 


如 此 我 们 就 将 定位 页 面 元 素 的 定位 表达 式 跟 程序 分 离 出 来 ,并 存储 在 一 个 专用 的 配置 
文件 PageElementLocator. ini 中 进行 集中 管理 ,后 续 如 果 页 面 结构 变 了 ,自动 化 测试 人 员 只 
需要 修改 此 文件 中 的 等 号 (=”) 后 面 的 定位 方式 和 定位 表达 式 即 可 ,由 此 提高 了 脚本 维护 
效率 。 

(12) 在 pageObjects 包 中 新 建 一 个 名 叫 HomePage. py 的 Python 文件 和 
AddressBookPage. py 文件 ,并 在 配置 文件 PageElementLocator. ini 中 补充 两 个 页 面 的 页 面 
元 素 的 定位 表达 式 。 

PageElementLocator. ini 配置 文件 更 新 后 的 内 容 如 下 : 




















[126mail login] 

loginPage.frame - id» x- URS- iframe 

loginPage. username = xpath »//input[(? name = 'email'] 
loginPage. password = xpath »//input[(?name = 'password'] 
loginPage. loginbutton - id» dologin 


[126mail homePage] 
homePage. addressbook = xpath»//div[text() = ' 通 讯 录 '] 


[126mail addContactsPage] 
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addContactsPage. createContactsBtn = xpath»//span[text() = ' 新 建 联系 人 '] 
addContactsPage.contactPersonName = xpath »//a[(v? title = ' 编 辑 详 细 姓 名 ' ]/preceding - 
sibling: :div/input 

addContactsPage. contactPersonEmail = xpath>// * [ @id = 'iaddress MAIL wrap']//input 
addContactsPage. starContacts = xpath »//span[text() = ' 设 为 星 标 联系 人 ']/preceding - sibling:: 
span/b 

addContactsPage. contactPersonMobile = xpath>// * [ @id = 'iaddress TEL wrap']//dd//input 
addContactsPage. contactPersonComment = xpath >//textarea 

addContactsPage. savecontacePerson = xpath>//span[. = ' 确 定 '] 


HomePage. py 文件 内 容 如 下 : 


# encoding = utf - 8 
from util.ObjectMap import * 
from util.ParseConfigurationFile import ParseCofigFile 


class HomePage(object) : 


def _ init (self, driver): 
self.driver - driver 
self.parseCF - ParseCofigFile() 


def addressLink(self): 

try: 
# OMEN E IASCBO POCHE P BERE fo iR R EIL E 7p BLA AC 
locateType, locatorExpression = self.parseCF.getOptionValueV 

("126mail homePage", "homePage. addressbook" ). split("»" ) 

EOEHUSE RJ JUI BA BE E RR LER PLA BUT E 
elementObj = getElement(self.driver, locateType, locatorExpression) 
return elementObj 

except Exception, e: 


raise e 


AddressBookPage. py 文件 内 容 如 下 : 


# encoding = utf - 8 
from util.ObjectMap import * 
from util.ParseConfigurationFile import ParseCofigFile 


class AddressBookPage(object) : 


def init (self, driver): 
self.driver - driver 
self.parseCF - ParseCofigFile() 
self.addContactsOptions = self.parseCF.getltemsSection("126mail addContactsPage" ) 
print self. addContactsOptions 


def createContactPersonButton(self): 
# RIEKA HA 
try: 
# MEURE PLC MEP EROE EK RA BEHLI XE Bi Zr AIKE 
locateType, locatorExpression = self. addContactsOptions\ 
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[" addContactsPage. createContactsBtn" . lower() ]. split("»") 
E OON SEIUR AI MHIR, 并 返回 给 调用 者 
elementObj = getElement(self.driver, locateType, locatorExpression) 
return elementObj 
except Exception, e: 
raisee 


def contactPersonName(self): 

E HEKRA H DI EE GL ig AHE 
try: 
E MIERE SCBO E X ME PH EDOR RA HER i A TER AE fr Ir CURIAE AC 

locateType, locatorExpression - self.addContactsOptionsV 
["addContactsPage. contactPersonName" . lower() ]. split("»") 
EON SE ICA P IRI HEK fi A TEE T ICR , EAR IL A BUE 
elementObj - getElement(self.driver, locateType, locatorExpression) 
return elementObj 
except Exception, e: 
raise e 


def contactPersonEmail(self): 

# HEIA EIK R AP BD P IO rl F HE TE dig A HE 

try: 
# MAE RIEA PE Er iE HOK RA HIER A HE MYE fr Ir HIA C 
locateType, locatorExpression - self.addContactsOptions V 

[" addContactsPage. contactPersonEmail". lower() ]. split("»") 

E DAN SERA PII HIERO di A HE DT TIE ZE, EAR TL A BUT E 
elementObj = getElement(self.driver, locateType, locatorExpression) 
return elementObj 

except Exception, e: 
raise e 


def starContacts(self): 

# DRIEK RA JE T P h EAR IKRA EERE 

try: 
# MIE RIIA E É'E P ER ERIK RA I i HE MGE fr Ir HIA A C 
locateType, locatorExpression = self.addContactsOptions V 

["addContactsPage. starContacts" . lower() ]. split("»") 

# OGHCBE SERRA P T AY E EIER A, EVE TEE TU IBI IO, EGER IL Ae BUM E 
elementObj = getElement(self.driver, locateType, locatorExpression) 
return elementObj 

except Exception, e: 
raise e 


def contactPersonMobile(self): 
EOOION SER AP BED UAR AF LE A E 
try: 
# MOEDBCREISSUM PLC PPP ROBUR ATL S A EIE B Zr CHI AC 
locateType, locatorExpression - self.addContactsOptions V 
[" addContactsPage. contactPersonMobile". lower()].split("»") 
E OON REIR ABUS ACTBLE S A HETE , EAR oL e BUE E 
elementObj = getElement(self.driver, locateType, locatorExpression) 
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return elementObj 
except Exception, e: 


raise e 


def contactPersonComment ( self): 

E KRIER APT ERA GETE fp B AHE 

try: 
# MERE SCBO PEOCIT P EOK RA BETE fi E fi A HE HU XE Fr Ir CRURA AC 
locateType, locatorExpression = self.addContactsOptions V 

[" addContactsPage. contactPersonComnment" . lower() ]. split("»") 

# DRI SERA D T MIKRA p TE fri EUR A Te EIE TO RR, 并 返回 给 调用 者 
elementObj - getElement(self.driver, locateType, locatorExpression) 
return elementObj 

except Exception, e: 


raise e 


def saveContacePerson( self): 

# EKR A IE H P M REKER A f 

try: 
# MIE K ISSUM PE F P ERIS FER A EE KYE f 7r EMKE 
locateType, locatorExpression = self.addContactsOptions V 

["addContactsPage. saveContacePerson" . lower() ]. split("»") 

# DEAN EIK A D T HY ARTF BORA E FH D IE ZE, EAR el A BET E 
elementObj = getElement(self.driver, locateType, locatorExpression) 
return elementObj 

except Exception, e: 


raise e 


(13) 在 DataDrivenFrameWork 工程 下 新 建 一 个 名 叫 testData 的 Directory CH 35D ,并 




































































在 该 目录 中 新 建 一 个 名 叫 *126 邮箱 联系 人 . xlsx” 的 Excel 文件 ,并 在 Excel 文件 中 创建 两 
个 工作 表 , 分 别 叫 *126 账号 “联系 人 "的 工作 表 , 其 内 容 分 别 如 表 15-1 和 表 15-2 Bron. 
表 15-1 
序号 用 户 名 密码 数据 表 是 否 执行 测试 结果 
1 XXX XXXX 联系 人 y 
2 yyy yyyy 联系 人 y 
表 152 
是 否 
联系 人 设 为 联系 人 验证 页 面包 含 ge | 执行 | 测试 
my 姓名 EXAM 星 标 全 备注 信息 的 关键 字 执行 | 时 间 | 结果 
联系 人 
1 lily |lily(2qq. com 是 135xxxxxxxl | 常 联系 人 |lily@qq. com y 
2 3K-— |zhangsan(2 qq. com 否 158xxxxxxx3 | 不 常 联系 人 | zhangsan@qq. com y 
3 amy |amy()qq. com 是 139xxxxx&8 amy n 
4 李 四 |lisi(2qq. com 8 157xxxxxx9 E s 
测试 过 程 中 需要 的 数据 单独 存放 到 数据 文件 中 ,不 仅 做 到 了 数据 与 程序 的 分 离 , 而 且 方 
便 管理 与 维护 ,自动 化 测试 人 员 只 需要 修改 数据 文件 中 的 数据 而 不 需要 改动 代码 ,就 可 以 完 
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成 针对 不 同 测试 数据 的 测试 工作 ,提高 了 测试 效率 和 成 本 。 
(14) 在 util 包 中 新 建 一 个 名 叫 ParseExcel. py 的 Python 文件 ,用 于 实现 解析 Excel 文 
件 的 方法 封装 ,具体 内 容 如 下 : 


# encoding = utf -8 

import openpyxl 

from openpyxl.styles import Border, Side, Font 
import time 


class ParseExcel(object): 


def — init (self): 
self.workbook - None 
self.excelFile - None 
self.font = Font(color = None) £ i£ Bb fk hi E 
# BÉ WI RGB fii 
self.RGBDict - ('red': 'FFFF3030', 'green': 'FF008B00'] 


def loadWorkBook(self, excelPathAndName): 
# 将 Excel X TF IIAUPIPI fg, HRH workbook 对 条 
try: 
self.workbook - openpyxl.load workbook(excelPathAndName) 
except Exception, e: 
raise e 
self.excelFile - excelPathAndName 
return self. workbook 


def getSheetByName(self, sheetName): 
# 根据 sheet 名 获取 该 sheet 对 条 
try: 
sheet - self.workbook.get sheet by name(sheetName) 
return sheet 
except Exception, e: 
raisee 


def getSheetByIndex(self, sheetIndex): 
# 根据 sheet 的 案 3| 号 获取 该 sheet 对 条 
try: 
sheetname = self.workbook.get sheet names()[sheetIndex] 
except Exception, e: 
raise e 
sheet - self.workbook.get sheet by name(sheetname) 
return sheet 


def getRowsNunber(self, sheet): 
# GEI sheet 中 有 数据 区 域 的 结束 行 号 


return sheet.max row 


def getColsNumber(self, sheet): 
# KIR sheet 中 有 数据 区 域 的 结 吏 列 号 
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return sheet. max column 


def getStartRowNumber(self, sheet): 
# HIR sheet PH EE IX BUE HIIT G 


return sheet.min row 


def getStartColNumber(self, sheet): 
* 获取 sheet (UE CIE IX POM JF AG 


return sheet.min column 


def getRow(self, sheet, rowNo): 
# 获取 sheet rh E — fr, 38 Ill] Je iX —f3 PETS BUE VAI EE ÍH I tuple, 
# FÉ M 1 Ft, sheet. rows[1] v 58 —fT. 
try: 
return sheet.rows[rowNo - 1] 
except Exception, e: 
raise e 


def getColumn(self, sheet, colNo): 
# HIR sheet 1h AE — 9), JE PAYE iX — PI Br Tr B CIE IAE FHAR tuple, 
# FERM 1 开始 , sheet. columns[1] 表 示 第 一 列 
try: 
return sheet.columns[colNo - 1] 
except Exception, e: 
raise e 


def getCellOfValue(self, sheet, coordinate - None,rowNo- None, colsNo - None): 
# WRIA PIE TED Bo PES o] HEN XAI PKI, FERM 1706, 
# sheet.cell(row = 1, column = 1).value, 表示 Excel (th? — f 98 — 3 HO E 
if coordinate ! - None: 
try: 
return sheet.cell(coordinate - coordinate).value 
except Exception, e: 
raise e 
elif coordinate is None and rowNo is not None and colsNo is not None: 
try: 
return sheet.cell(row - rowNo, column - colsNo).value 
except Exception, e: 
raise e 
else: 
raise Exception("Insufficient Coordinates of cell !") 


def getCellOfObject(self, sheet, coordinate - None, rowNo - None,colsNo- None): 

EORR T oc NEI ES, nTULURE POCNEPI TET PERI ECE EL, 
# 也 可 以 直接 根据 Excel rin JG NEGAR IC AER 
# 如 getCellObject(sheet, coordinate = 'A1') or 
# getCellObject(sheet, rowNo = 1, colsNo = 2) 
if coordinate ! - None: 

try: 

return sheet.cell(coordinate - coordinate) 
except Exception, e: 
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raise e 
elif coordinate -- None and rowNo is not None and colsNo is not None: 
try: 
return sheet.cell(row - rowNo,column - colsNo) 
except Exception, e: 
raise e 
else: 
raise Exception(" Insufficient Coordinates of cell !") 


def writeCell(self, sheet, content, coordinate - None, rowNo - None, colsNo - None, 
style - None): 
* REPITE Excel (nl Ag RRA AFR IER A PEASE, 
# FERM 工 开始 ,参数 style ER FM B EMA F, 比如 red, green 
if coordinate is not None: 
try: 
sheet.cell(coordinate = coordinate).value = content 
if style is not None: 
sheet.cell(coordinate = coordinate). V 
font - Font(color - self.RGBDict[style]) 
self. workbook. save(self.excelFile) 
except Exception, e: 
raise e 
elif coordinate == None and rowNo is not None and colsNo is not None: 
try: 
sheet.cell(row = rowNo,column = colsNo).value = content 
if style: 
sheet.cell(row = rowNo, column = colsNo).V 
font = Font(color = self. RGBDict[ style] ) 
self. workbook. save( self. excelFile) 
except Exception, e: 
raise e 
else: 
raise Exception(" Insufficient Coordinates of cell !") 


def writeCellCurrentTime(self, sheet, coordinate = None, rowNo = None, colsNo = None): 
# 写 人 当前 的 有 时间, FERM 工 开始 
now = int(time.time()) # fjv XHA] RE 
timeArray = time. localtime(now) 
currentTime = time.strftime(" $Y- %m- £d €H:*M: % S", timeArray) 
if coordinate is not None: 
try: 
sheet.cell(coordinate - coordinate).value - currentTime 
self. workbook. save(self.excelFile) 
except Exception, e: 
raise e 
elif coordinate == None and rowNo is not None and colsNo is not None: 
try: 
Sheet.cell(row = rowNo, column = colsNo).value = currentTime 
self.workbook.save(self.excelFile) 
except Exception, e: 


raise e 


. 321- 


a Selenium WebDriver 3.0 自动 化 测试 框架 实战 指南 


else: 
raise Exception(" Insufficient Coordinates of cell !") 


if name == ' main 
pe = ParseExcel() 
# 测试 所 用 的 Excel 文件 "126 邮箱 联系 人 . xlsx" 请 自行 创建 
pe. loadWorkBook(u'D:\\PythonProject\\126 邮箱 联系 人 .xlsx') 
print "通过 名 称 获取 sheet 对 象 的 名 字 :"，pe. getSheetByName(u" 联 系 人 ").title 
print "通过 index 序号 获取 sheet 对 象 的 名 字 : ", pe.getSheetByIndex(0).title 
sheet = pe.getSheetByIndex(0) 
print type(sheet) 
print pe.getRowsNumber(sheet)  £ CJ Xf 
print pe.getColsNumber(sheet)  Z JJ At X 9 5 
rows = pe.getRow(sheet, 1) # 获取 第 一 行 
for i in rows: 


print i.value 
# KRP- RAAT E 
print pe.getCellOfValue(sheet, rowNo = 1, colsNo = 1) 
pe.writeCell(sheet, u' 我 爱 祖国 ',，rowNo = 10, colsNo = 10) 
pe.writeCellCurrentTime(sheet, rowNo - 10, colsNo - 11) 


对 Python 解析 Excel 的 openpyxl 模块 进行 二 次 封装 ,以 满足 我 们 所 需 , 同 时 提供 给 其 
他 模块 直接 使 用 ,减少 重复 代码 的 编写 ,同时 方便 维护 。 

(15) 在 appModules 包 中 新 建 一 个 名 叫 AddContactPersonAction. py 的 Python X ff. 
用 于 实现 添加 联系 人 操作 ,有 具体 内 容 如 下 : 


# encoding - utf - 8 

from pageObjects. HomePage import HomePage 

from pageO0bjects. AddressBookPage import AddressBookPage 
import traceback 

import time 

class AddContactPerson(object): 


def — init (self): 
print "add contact person." 


(à) staticmethod 
def add(driver, contactName, contactEmail, isStar, contactPhone, contactComment): 
try: 
* 创建 主页 实例 对 和 象 
hp = HomePage(driver) 
# Mit iR R tt 
hp. addressLink().click() 
time. sleep(3) 
# 创建 添加 联系 人 页 实例 对 象 
apb = AddressBookPage(driver) 
apb. createContactPersonButton().click() 
if contactName: 
PE 727] 
apb. contactPersonName().send keys(contactName) 
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# 必 填 项 
apb. contactPersonEmail(). send keys(contactEmail) 
if isStar == ww 是": 
# Ivt 
apb. starContacts().click() 
if contactPhone: 
# Iket 
apb. contactPersonMobile().send keys(contactPhone) 
if contactConment: 
apb. contactPersonComment().send keys(contactConmment) 
apb. saveContacePerson() . click() 
except Exception, e: 
# HHUEH IB 
print traceback. print exc() 
raise e 
if name  -- ' main ': 
from LoginAction import LoginAction 
from selenium import webdriver 
import time 
# 启动 Firefox NJ V at 
driver = webdriver.Chrome(executable path = "c: W chromedriver") 
# 访问 126 邮箱 首页 
driver. get("http://mail.126.conm") 
# driver.maximize window() 
time. sleep(5) 
LoginAction.login(driver, "xxx", "xxx" ) 
time. sleep(5) 
AddContactPerson.add(driver, u" 张 三 ", "zs(àqq.com", u" 是 ", "", "") 
time. sleep( 3) 
assert u" 张 三 " in driver. page_source 
driver.quit() 


(16) 修改 config 包 下 的 VarConfig. py 文件 内 容 如 下 : 
# encoding - utf - 8 


import os 


* ORC BÉ X TEPE TE H RIR HE BU IEEE GG 
parentDirPath = os.path.dirname(os.path.dirname(os.path.abspath( file ))) 


# GIC BRI EE E RE IA CC Ó'F I 4B ERES 
pageElementLocatorPath = parentDirPath + u"VW config V MPageElementLocator. ini" 


# EHE X lH fg UB x EE 
dataFilePath = parentDirPath + u"WtestData M26 邮箱 联系 人 .xlsx" 


# 126 KG TERP, S ADI ECE TES 
account username - 2 
account password - 3 
account dataBook - 4 
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account isExecute = 5 
account testResult = 6 


# KRATERE, GARFE G 
contacts contactPersonName = 2 
contacts contactPersonEmail - 3 
contacts isStar - 4 

contacts contactPersonMobile - 5 
contacts contactPersonComment - 6 
contacts assertKeyWords - 7 

contacts isExecute - 8 

contacts runTime - 9 

contacts testResult - 10 


(17) 修改 testScripts 包 中 的 TestMaill26AddContacts. py 文件 内 容 如 下 : 


# encoding = utf - 8 

from selenium import webdriver 

from selenium. webdriver.chrome. options import Options 

from util.ParseExcel import ParseExcel 

from config. VarConfig import * 

from appModules.LoginAction import LoginAction 

from appModules. AddContactPersonAction import AddContactPerson 
import traceback 

from time import sleep 


# 设置 此 次 测试 的 环境 编码 为 utf -8 
import sys 

reload( sys) 

sys. setdefaultencoding("utf - 8") 


* 创建 解析 Excel 对 条 

excel0bj = ParseExcel() 

# 将 Excel 数据 文件 加 载 到 内 存 
excelObj. loadiWorkBook(dataFilePath) 


def LaunchBrowser() : 
# 创建 Chrone JJ $$ ff] —f* Options Sz [HX] $e 
chrome options - Options() 
# 向 Options 实例 中 添加 禁用 扩展 插件 的 设置 参数 项 
chrome options.add argument(" -- disable - extensions") 
# 添加 屏蔽 —— ignore - certificate - errors 提示 信息 的 设置 参数 项 
chrome options.add experimental optionV 
("excludeSwitches", ["ignore- certificate - errors"]) 
# SIUE ME ERA ME BI EE BE BEC, 已 启动 就 最 大 化 
chrome options.add argunent(' -- start - maximized') 
# JAHA HIE X BER Chrone W W 4E 
driver = webdriver. ChromeV 
(executable path- "c:\\chromedriver", chrome options = chrome options) 
* 访问 126 邮箱 首页 
driver. get("http://mail. 126.com" ) 
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sleep(3) 
return driver 


def test126MailAddContacts(): 
try: 
* IRE Excel 文件 由 sheet 4 fki Hult sheet 对 条 
userSheet = excelObj.getSheetByName(u" 126 账号 " ) 
# 获取 126 账号 sheet 由 是 否 热 行列 
isExecuteUser = excelObj.getColumn(userSheet, account isExecute) 
* 获取 126 账号 sheet 中 的 数据 表 列 
dataBookColumn = excelObj. getColumn(userSheet, account dataBook) 
print u 测试 为 126 邮箱 添加 联系 人 执行 开始 ..." 
for idx, i in enunerate(isExecuteUser[1:]): 
# MIR 126 IK 5 Se GE, A a EAT HKG REMERA 
if i value == "y': £ 表示 要 执行 
# 菊 肥 第 i 行 的 数据 
userRow = excelObj.getRow(userSheet, idx + 2) 
# UIS idt 
username - userRow[account username - 1].value 
# RRA iris) 
password - str(userRow[account password - 1].value) 
print username, password 


# Qa EIRE 


driver = LaunchBrowser() 


BOW 126 M AG. 
LoginAction.login(driver, username, password) 
# EIF 3 Eb, IEW EIS El SI UAR, LA ME TE E DE ÍT FERRE 
sleep(3) 
# 获取 为 第 i 行 中 用 户 添加 的 联系 人 数据 表 sheet 4 
dataBookName = dataBookColumn[ idx + 1].value 
# 获取 对 应 的 数据 表 对 象 
dataSheet = excelObj.getSheetByName(dataBookName) 
# 获取 联系 人 数据 表 中 是 否 执 行列 对 象 
isExecuteData = excelObj.getColumn(dataSheet, contacts isExecute) 
contactNum = 0 £ 记录 添加 成 功 联系 人 个 数 
isExecuteNum = 0 £ 记录 需要 执行 联系 人 个 数 
for id, data in enumerate(isExecuteData[1:]): 
# MEIR dE SATUS IUBCR A PI, 
# MRD UER A Sn, WEITER AGREE 
if data. value == "y": 
# MRP id FTIICR A WR AEAHAIT M isExecuteNum Hi% 1 
isExecuteNum += 1 
EONKOIUK AKI id+ 2 行 对 条 
rowContent = excelObj.getRow(dataSheet, id + 2) 
# 获取 联系 人 姓名 
contactPersonName = \ 
rowContent[contacts contactPersonName — 1].value 
# KUKRAK 
contactPersonEmail = V 
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rowContent[contacts contactPersonEmail — 1]. value 
# 黎 肥 是 否 设 置 为 星 标 联系 人 
isStar = rowContent[contacts isStar - 1].value 
zORKUHURRACFBLS 
contactPersonPhone - V 

rowContent[contacts contactPersonMobile - 1]. value 
# 获取 联系 人 备注 信息 
contactPersonComment = V 

rowContent[contacts contactPersonComment - 1]. value 
# 添加 联系 人 成 功 后 ,断言 的 关键 字 
assertKeyWord = V 

rowContent[contacts assertKeyWords — 1].value 
print contactPersonName, contactPersonEmail, assertKeyWord 
print contactPersonPhone, contactPersonComment, isStar 
# 热 行 新 建 联系 人 操作 
AddContactPerson. add(driver, 

contactPersonName, 

contactPersonEmail, 

isStar, 





contactPersonPhone, 
contactPersonComment) 
sleep(1) 
# 在 联系 人 工作 表 中 写 人 添加 联系 人 执行 时 间 
excel0bj. writeCellCurrentTime( dataSheet, 
rowNo = id + 2, colsNo = contacts runTime) 
try: 
* MN EAE E E th PETE CIE P 
assert assertKeyWord in driver.page source 
except AssertionError, e: 
# OBERE M, EKRA TWR PG A RMK ABE IC (ER 
excelObj.writeCell(dataSheet,"faild",rowNo = id+2, 
colsNo = contacts testResult, style = "red") 
else: 
# 断言 成 功 , ARS TLBERR ARD i ER 
excelObj.writeCell(dataSheet,"pass",rowNo = id 42, 
colsNo- contacts testResult, style = "green" ) 
contactNum += 1 
print "contactNum = % s, isExecuteNum = 5$ s"V 
5 (contactNum, isExecuteNum) 
if contactNum -- isExecuteNum: 
# MRD S M GERA REC its RS DL IRA BAE, 
# 说 明 给 第 i 个 用 户 添加 联系 人 测试 用 例 执 行 成 功 ,， 

# 在 126 三 号 工作 表 中 写 人 成 功 信 息 , 否则 写 人 失败 信息 
excelObj.writeCell(userSheet, "pass", rowNo = idx + 2, 
colsNo - account testResult, style - "green") 

print u" 为 用 户 $s 添加 sd 个 联系 人 ,测试 通过 !"\ 
$ (username, contactNum) 
else: 
excelObj.writeCell(userSheet, "faild", rowNo = idx + 2, 
colsNo - account testResult, style - "red") 


else: 
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print u" HA %s 被 设置 为 忽略 执行 !” *excelObj. getCellOfValueV 
(userSheet, rowNo = idx + 2, colsNo = account username) 
driver.quit() 
except Exception, e: 
print u 数据 驱动 框架 主 程序 发 生 异 常 ,异常 信息 为 : 
# 打印 异常 堆栈 信息 
print traceback.print exc() 


if name  -- ' main 


testl26MailAddContacts() 
print u" 登录 126 邮箱 成 功 !" 
(18) 在 DataDrivenFrameWork 工程 根 目 录 中 创建 一 个 名 叫 RunTest. py 的 Python 文 
件 ,用 于 编写 整个 数据 驱动 框架 运行 的 主 入 口 代码 ,具体 代码 如 下 : 


#encoding= utf - 8 
from testScripts. TestMaill26AddContacts import * 


if name  -- ' main 


test126MailAddContacts() 


在 config 包 中 的 VarConfig. py 文件 中 定义 了 多 个 常量 ,在 测试 脚本 文件 
TestMaill26AddContacts. py 中 多 行 代码 调用 了 这 些 常 量 , 实 现 了 测试 数据 在 测试 方法 中 
的 重复 使 用 ,如 果 需 要 修改 数据 ,只 需要 修改 VarConfig. py 文件 中 的 常量 值 就 可 以 实现 在 
全 部 测试 过 程 生 效 ,减少 了 代码 的 维护 成 本 ,同时 也 增加 了 测试 代码 的 可 读 性 。 

在 TestMaill26 AddContacts. py 文件 中 改 为 从 Excel 数据 文件 中 读 取 测试 数据 ,作为 
数据 驱动 框架 测试 过 程 中 的 数据 来 源 ,执行 完 某 条 测试 用 例 后 , 则 会 在 Excel 数据 文件 最 后 
两 列 分 别 写 入 “测试 执行 时 间 ” 和 “测试 结果 ”。 

经 过 以 上 步骤 ,一 个 简单 的 数据 驱动 框架 雏形 就 完成 了 ,但 我 们 还 需要 加 入 打印 日 志 的 
功能 ,让 它 看 起 来 更 完善 一 点 。 

(19) 通过 logging 模块 ,为 数据 驱动 框架 加 入 打印 日 志 功 能 。 在 config 包 中 新 建 一 个 
名 叫 Logger. conf 的 文件 ,用 于 配置 日 志 基 本 信息 ,具体 内 容 如 下 : 

# logger. conf 
BRBBBBBUBUBDPÉSESUSUSUESEPUUSUBUBUEUBUBEBEDBDEBBBBR 
loggers 

as iud example01, example02 

logger root] 

level = DEBUG 

handlers = hand01, hand02 


logger example01] 
handlers - hand01, hand02 
qualname - example01 
propagate - 0 





logger example02] 
handlers - hand01, hand03 
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qualname = example02 
propagate - 0 


BRBÉBBBSBSRSSRBRBRTSSESERESRESEREBSBBEBBBABABNAAAR 
[handlers] 
keys = hand01 , hand02, hand03 


[handler hand01] 
class = StreamHandler 
level = INFO 
formatter = form01 
args = (sys. stderr, ) 


[handler hand02] 

class - FileHandler 

level - DEBUG 

formatter - form01 

args = ('logWDataDrivenFrameWork.log', 'a') 


[handler hand03] 

class - handlers. RotatingFileHandler 

level - INFO 

formatter = form01 

args = ('logWDataDrivenFrameWork.log', 'a', 10 x 1024 « 1024, 5) 


提亲 井 间 井 间 并 间 并 间 并 并 并 并 并 并 并 间 并 并 并 间 间 间 并 井 间 并 并 并 并 间 并 并 并 并 并 并 并 并 并 并 并 并 并 并 并 
[formatters] 
keys = form01, form02 


[formatter form01] 
format = % (asctime)s *(filename)s[line: % (lineno)d] % (levelname)s % (message)s 
datefnt- $Y- $m- $d $H: M: $S 


[formatter form02] 
format = % (name)- 12s: % (levelname) -8s % (message)s 
datefmt = $Y- $m- $d $H: $M: $S 


(20) f£ util 包 中 新 建 一 个 名 叫 Log. py 的 Python 文件 ,用 于 初始 化 日 志 对 象 , 具 体内 
XMF: 


# - * - coding: UTF-8 - * 一 
import logging 

import logging. config 

from config. VarConfig import parentDirPath 


# 读 肥 日 志 配 置 文 件 

logging. config. fileConfig(parentDirPath + u"\config\Logger. conf" ) 
# dETE— HZ NEA 

logger = logging.getLogger(" example02" ) z z # example01 


def debug(nessage) : 


。 328 - 





第 15 章 自动 化 测试 框架 的 搭建 及 测试 实战 © 


# 定义 dubug KH H EHT AA E 
logger. debug( message) 


def info(message) : 
# ENX info 级 别 日 志 打 印 方 法 


logger. info(message) 


def warning(message): 
# 定义 warning 级 别 日 志 打 印 方法 


logger. warning(message) 


(21) 在 DataDrivenFrameWork 工程 根 目录 下 创建 一 个 名 叫 log 的 目录 ,然后 修改 
testScripts 包 中 的 TestMail126AddContacts. py 文件 内 容 如 下 : 


#encoding= utf -8 

from selenium import webdriver 

from selenium. webdriver. chrome. options import Options 

from util. ParseExcel import ParseExcel 

from config. VarConfig import x 

from appModules. LoginAction import LoginAction 

from appModules. AddContactPersonAction import AddContactPerson 
import traceback 

from time import sleep 

from util. Log import * 


# 设置 此 次 测试 的 环境 编码 为 utf — 8 
import sys 

reload(sys) 

Sys. setdefaultencoding("utf - 8") 


# OR T Excel 对 象 
excelObj = ParseExcel() 


# 将 Excel 数据 文件 加 裁 到 内 存 
excel0bj. loadWorkBook(dataFilePath) 


def LaunchBrowser() : 
* 创建 Chrome WAER If] —f* Options Sz [H x] $e 
chrome options - Options() 
& 向 Options X ffi P fs Jn 26 TH HP IP PEU REPE E 
chrome options.add argument(" -- disable - extensions") 
# MEK —— ignore - certificate - errors 提示 信息 的 设置 参数 项 
chrome options.add experimental optionV 
("excludeSwitches", [" ignore - certificate - errors"]) 
# OBRA MES A MEM EIE BO, 一 启动 就 最 大 化 
chrome options.add _ argument(' -- start - maximized') 
# JAWA FIXE X EPIS Chrome W H d$ 
driver = webdriver. Chrome 
(executable path- "c: V chromedriver", chrome options = chrome options) 
# 访问 126 I 18 Pf 
driver.get("http://mail.126.com") 
sleep(3) 


. 329 - 


5 ‘Selenium WebDriver 3.0 一 | 自动 化 测试 框架 实战 指南 
e 


return driver 


def test126MailAddContacts(): 
logging. info(u"126 邮箱 添加 联系 人 数据 驱动 测试 开始 ...") 
try: 
# RHE Excel 文件 中 sheet 各 其 获取 此 sheet 对 条 
userSheet = excel0bj. getSheetByName(u"126 账号 ") 
# 获取 126 账号 sheet 中 是 否 执 行列 
isExecuteUser = excelObj.getColumn(userSheet, account isExecute) 
* 获取 126 账号 sheet 中 的 数据 表 列 
dataBookColumn = excel0bj. getColumn(userSheet, account dataBook) 


for idx, i in enunerate(isExecuteUser[1:]): 
# MIR 126 账号 表 中 的 账号 ,为 需要 执行 的 账号 添加 联系 人 
if i.value == "y": £ 表示 要 执行 
# KRH idx+ 2 行 的 数据 
userRow = excelObj.getRow(userSheet, idx + 2) 
# 获取 第 idx +2 行 中 的 用 户 和 名 
username = userRow[account username - 1].value 
# 获取 第 idx+ 2 行 中 的 密码 
password = str(userRow[account password - 1].value) 
print username, password 


* Qua a Sc IX ge 
driver = LaunchBrowser() 


logging. info(u" 启 动 浏览 器 ,访问 126 邮箱 主页 ") 


# 登录 126 邮箱 
LoginAction.login(driver, username, password) 
E BIF 3 Eb, ERRARE R, DUBIE IET BEBE 
sleep(5) 
try: 
# EAE R Se BERE DUI B CAE Fn A "A eA 
assert u" 收 信 ” indriver.page source 
logging. info\ 
(AA S s 登录 后 ,断言 页 面 关 键 字 " 收 信 " 成 功 ”$ username) 
except RssertionError，e: 
logging.debug(u" 用户 % s 登录 后 ,断言 页 面 关 键 字 " 收 信 " 失 败 ," 
u" 异 常 信息 : *s" % (username, str(traceback. format exc()))) 
# 获取 为 第 idx* 2 fT JH PH Mn UBER AH sheet 名 
dataBookName - dataBookColumn[idx * 1].value 
# 获取 对 应 的 数据 表 对 象 
dataSheet = excelObj.getSheetByName(dataBookName) 
# OGOURCR AREE TUE SD PIER 
isExecuteData = excelObj.getColumn(dataSheet, contacts isExecute) 
contactNum = 0 # 记录 添加 成 功 联系 人 个 数 
isExecuteNum = 0 £ 记录 需要 执行 联系 人 个 数 
for id, data in enumerate(isExecuteData[1:]): 
# (BERG HIIS ATIS IDEAS, 
# MREGA E, 则 进行 联系 人 添加 操作 
if data. value == "y": 
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# MRP id THIRRA BEDEBIOU DUET, HJ isExecuteNum H iğ 1 
isExecuteNum += 1 
# KIUKCR AKI id e 2 行 对 条 
rowContent = excelO0bj.getRow(dataSheet, id + 2) 
# 黎 肥 联系 人 各 
contactPersonName = V 
rowContent[contacts contactPersonName — 1]. value 
# 获取 联系 人 邮件 
contactPersonEmail = V 
rowContent[contacts contactPersonEmail - 1]. value 
# 获取 是 否 设置 为 星 标 联系 人 
isStar = rowContent[contacts isStar — 1].value 
# 获取 联系 人 手机 号 
contactPersonPhone = V 
rowContent[contacts contactPersonMobile - 1]. value 
# 获取 联系 人 备注 和 信息 
contactPersonComment = V 
rowContent[contacts contactPersonComment - 1]. value 
*OMSIDBCR AI BL IB E R EF 
assertKeyWord = V 
rowContent[contacts assertKeyWords — 1].value 
print contactPersonName, contactPersonEmail, assertKeyWord 





print contactPersonPhone, contactPersonComment, isStar 
# 执行 新 建 联系 人 操作 
AddContactPerson. add(driver, 
contactPersonName, 
contactPersonEmail, 
isStar, 
contactPersonPhone, 
contactPersonComment) 
sleep(1) 
logging. info(u" 添 加 联系 人 ss 成 功 ”$ contactPersonEmail) 


# KRA TWERK PGA EMKA ITH 
excel0bj. writeCellCurrentTime(dataSheet, 
rowNo = id + 2, colsNo = contacts_runTime) 
try: 
# BFT R E hI E E HI BU W i P 
assert assertKeyWord in driver. page_source 
except AssertionError, e: 
# MR KM, EKRA TER PG A RE KRA WEK IC (e E 
excelObj.writeCell(dataSheet,"faild",rowNo = id+ 2, 
colsNo = contacts testResult, style = "red" ) 
logging. info(u" 断言 关键 字 " % s" WI" s assertKeyWord) 
else: 
E 断言 成 功 , GAR TIC ARD ER 
excelO0bj.writeCell(dataSheet,"pass",rowNo = id+ 2, 
colsNo- contacts testResult, style = "green" ) 
contactNum += 1 
logging. info(u" 断言 关键 字 " % s" 成 功 ”% assertKeyWord) 
else: 


. 31- 


自动 化 测试 框架 实战 指南 


logging. info(u" 联系 人 ss 被 忽略 执行 ”s# contactPersonEmail) 
if contactNum == isExecuteNum: 
# RRD EM AERA 3 i 8 TIS LU BER AERIS, 
E URAR i PAP EMKA WEA PHA FT RD, 
# 在 126 IK £T ERPGARD AE, BUGAR K AE 
excelObj.writeCell(userSheet, "pass", rowNo = idx + 2, 
colsNo = account testResult, style = "green" ) 
else: 
excel0bj. writeCell(userSheet, "faild", rowNo = idx + 2, 
colsNo = account testResult, style = "red" ) 
logging. info(u" 为 用 户 各 s 添 加 %d 个 联系 人 ,%d 个 成 功 \n"\ 


* (username, isExecuteNum, contactNum)) 





y A else: 

A # XO at Ruin s 

A ignoreUserName = excelObj.getCellOfValue(userSheet, 

rowNo - idx * 2, colsNo - account username) 
logging. info(u" 用户 $s 被 忽略 执行 \n”$ ignoreUserName) 
driver.quit() 
except Exception, e: 
logging. debug(u" 数 据 驱 动 框架 主 程序 执行 过 程 发 生 异 常 ,异常 信息 : % s"\ 
5 str(traceback.format exc())) 


(22) 运行 RunTest. py 文件 ,执行 结束 后 可 以 在 工程 目录 下 的 Log 目录 中 看 到 打印 的 
日 志文 件 DataDrivenFrameWork. log ,文件 所 包含 的 内 容 如 图 15-6 所 示 , 这 里 只 粗略 地 打 
印 了 一 些 执 行 过 程 信息 ,读者 可 以 添加 更 加 详细 的 打印 日 志 信 息 , 以 便 查 看 更 详细 的 执行 过 
程 逻 辑 , 后 续 用 于 测试 执行 中 的 问题 分 析 和 过 程 监控 。 








17:58:51 TestMaill26AddContacts. py[line:24] INFO ONERE A EDEN BUT. - 
01 TestMaill26AddContacts.py[line:46] INFO 启动 浏览 器 ， 访 问 126i EN 页 





15 TestMaill26AddContacts.py[line:102] INFO 3 
18 TestMaill26AddContacts.py[l1ine:120] INFO ER pu Run com” 成 功 
20 TestMaill26AddContacts.py[line:102] INFO 潍 加 联系 人 zhangsan8qq. com 成 功 


2017-01-11 20 TestMaill26AddContacts.py[line:120] INFO 断言 关键 字 “zhangsan6qq. com" 成功 
2017-01-11 20 TestMaill26AddContacts.py[line:122] INFO 联系 人 zhangsangqq. com 被 总 略 执行 
2017-01-11 TestMaill26AddContacts.py[line:102] INFO EARRA com 成 功 
2017-01-11 TestMaill26AddContacts.py[line:120] INFO 断言 关键 字 “ 李 四 ”成 功 


5 
g 
5 
2 


:59:25 TestMaill26AddContacts.py[line:133] INFO 为 用 户 AgilityToSR 漆 加 3 个 联系 人 ，3 个 成 功 
2017-01-11 17:59:28 TestMaill26AddContacts. py[line:138] INFO 用 户 chenliangjuen 被 忽略 执行 


图 15-6 


打开 Excel 数据 文件 ,可 以 看 到 两 个 表 中 的 都 写 入 了 本 次 执行 成 功 或 失败 的 信息 ,如 
图 15-7 和 图 15-8 所 示 。 





























第 15 章 自动 化 测试 框架 的 搭建 及 测试 实战 

















lllily lilyqg. com. 是 l35xxxxxxxl | 党 联系 人 lilyfqq. com. y [2017-01-11 17:59:13  |pass 
2| 张 三 zhangsanéqq. com lo8xxxxxxx [FERE A zhangsanfqg com |y j2017-01-11 17:59:20 pass 
3fany amyëqq. com 是 Bons | amy A [ 

C Fn lisiqq. com is 157xxxxxxx9 | Ei] 下 [2017-01-11 17:89:28 — [pass 





























图 15-8 

至 此 ,数据 驱动 测试 框架 全 部 搭建 完成 ,在 Py Charm 工具 中 ,整个 工程 的 结构 如 图 15-9 
所 示 。 

数据 测试 驱动 框架 的 优点 分 析 ， Dit ) tee Test 

CD 通过 配置 文件 ,实现 页 面 元 素 定位 表达 式 [mee | Oore] 
和 测试 代码 的 分 离 kp chc EE DAPythonProjectNDat| 

(2) 使 用 ObjectMap 方式 ,简化 页 面 元 素 定 位 @ init .py 
相关 的 代码 工作 量 。 [È AddContactPersonAction.py 


[IÈ LoginAction.py 
(3) 使 用 PageObject( 页 面 对 象 ) 模 式 , 封 装 了 v © config 


网 页 中 的 页 面 元 素 ,方便 测试 代码 调用 ,也 实现 了 一 | A 

处 维护 全 局 生效 的 目标 。 A MADE S 
(4) 在 appModules 的 Package 中 封装 了 常用 的 v Diog : 

页 面 对 象 操作 方法 ,简化 了 测试 脚本 编写 的 工作 量 。 d se cR 
(5) 在 Excel 文件 中 定义 多 个 测试 数据 ,每 个 @ init py 

126 用 户 都 一 一 对 应 一 个 存放 联系 人 数据 的 工作 表 ， dementis d 

测试 框架 可 自动 调用 测试 数据 完成 数据 驱动 测试 。 区 Loginpagepy 


(6) 实现 了 测试 执行 过 程 中 的 日 志 记录 功能 ， | T DE 


可 以 通过 日 志文 件 分 析 测 试 脚本 执行 的 情况 。 M Wi testScripts 
(7) 在 Excel 数据 文件 测试 数据 行 中 ,通过 设 定 li init -py 


[È TestMail126AddContacts.py 


“测试 数据 是 否 执行 ? 列 的 内 容 为 > 或 者 mn, 可 自 定义 | v funi 


选择 测试 数据 ,测试 执行 结束 后 会 在 “测试 结果 " 列 中 je 入 
显示 测试 执行 的 时 间 和 结果 ,方便 测试 人 员 查 看 。 [È ObjectMap py 
$ " i [È ParseConfigurationFile.py 
本 例 中 使 用 操作 Excel 文件 的 方式 定义 和 维护 sarium 
测试 数据 及 测试 结果 ,如 果 读者 擅长 数据 库 和 网 页 | b Rintestpy 
开发 技术 ,可 以 借鉴 此 框架 的 思想 实现 基于 数据 库 S 
和 网 页 架构 的 数据 驱动 框架 。 借 助 Web 方式 ,测试 图 15-9 


人 员 可 以 通过 浏览 器 来 进行 数据 驱动 测试 ,完成 测 
试 数据 的 定义 、 测 试用 例 的 执行 和 测试 结果 的 查看 。 


15.3 S EELEE 


本 节 主 要 讲解 关键 字 驱 动 测试 框架 的 搭建 过 程 ,并 且 使 用 此 框架 来 测试 126 邮箱 登录 
和 发 送 邮件 等 相关 功能 。 关 键 字 框 架 用 到 的 基础 知识 均 在 前 面 的 章节 做 了 详细 介绍 ,本 节 
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点 讲解 框架 搭建 的 详细 过 程 。 
被 测试 功能 的 相关 页 面 描述 如 下 : 
登录 页 面 如 图 15-10 所 示 。 


MARRS | 你 的 专业 电子 邮局 sanm cosa vimus MAPD EXukcu MM RUUD | NE 


we 126.00m 


DP 











mugs EE 
锌 合金 蔬菜 专用 削 皮 器 用 户 名 输入 框 0 
E. CAD ensem 
Ere 密码 输入 框 _ 
立即 抢 >> c E. 
十 天 内 免费 对 mice? 
去 注册 


Rit: mums .登录 按钮 Engsste 和 


(Dite EP [Faem 


图 15-10 
登录 后 的 页 面 如 图 15-11 所 示 。 


12679». 





agilitytosro126.com ~ W NEm Fp 升级 服务 










通讯 录 应 用 中 心 收 件 箱 网 易于 -起 


Ak 区 写 信 
wangchenxin ,放下 担子 ， 过 随遇而安 的 生活 

收 件 箱 (6) i o 
M TI 邮件 ga O P^ o ea 
O tow 未 读 邮件 竺 办 邮件 。 联系 人 邮件 。” 积分 -98 WWE 
X memos 单 击 写 信 链接 ， 进 入 写 信 页 面 
草稿 箱 (4) 
已 发 送 

? was ^al 了 

图 15-11 


单 击 “ 写 信 ? 链 接 后 ,进入 写 信 页 面 ,如 图 15-12 所 示 。 
发 送 邮件 成 功 后 显示 的 页 面 如 图 15-13 所 示 。 
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agilitytesrG126.com v W 





收 件 人 
主 题 
重 添加 附件 (最 大 3G) 升 至 15G | v 从 手机 上 传 图 片 


BIUMAMNAEI-CUGODESI! s Dam 





[P 1. Jointa 





© 可 用 手机 接收 回复 口 免费 短信 通知 
e 返回 收 件 箱 查看 已 发 邮件 继续 写 信 。 已 成 功 发 送 到 收 件 人 (1) ， 


邮件 发 送 成 功 后 ， 页 面 展 示 的 关键 字 


图 15-13 
非 关 键 字 驱 动 框架 时 的 发 送 邮 件 自动 化 测试 代码 : 


# encoding- utf -8 

from selenium import webdriver 

from selenium. webdriver. common. keys import Keys 

from selenium. webdriver. common. by import By 

from selenium. webdriver. support. ui import WebDriverWait 

from selenium. webdriver. support import expected conditions as EC 
import time 


print u" 启 动 浏览 器 ..." 

# 创建 Chrome 浏览 移 的 实例 

driver = webdriver.Chrome(executable path="c:\\chromedriver") 
# KIEN ie BI 
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driver. maximize window() 
print u" 启 动 浏览 器 成 功 " 
print u" 访 问 126 邮箱 登录 页 ..." 
driver. get("http://mail.126. com") 
# HE 5E, 以便 邮箱 登录 页 面 加 裁 完成 
time. sleep(5) 
assert u"126 网 易 免 费 邮 -- 你 的 专业 电子 邮局 ”in driver. title 
print u" 访 问 126 邮箱 登录 页 成 功 " 
# 创建 显 式 等 任 
wait = WebDriverWait(driver，30) 
# KÆ id} x-URS- iframe 的 frame 4e fff fk, PFIED H fa UE frame fi ff 
wait.until(EC.frame to be available and switch to it((By. ID, "x - URS- iframe"))) 
# 获取 用 户 名 答 人 征 
userName = driver.find element by xpath('//input[@name = "email"]') 
# AMPK 
userName. send keys(" xxx" ) 
# OX IPMA fie 
pwd = driver.find element by xpath("//input[(Zname = 'password']") 
# AS 
pwd. send keys(" xxx" ) 
# RNE RE 
pwd. send keys(Keys. RETURN) 
print "ARER..." 
# GEIF S Eb, 以便 登 录 成 功 后 的 页 面 加 载 完 成 
time. sleep(5) 
assert u" 网易 邮箱 "in driver. title 
print u" REIH" 
print u' Sf..." 
E MIENE e BE BER BOO IU HL 
element = wait. until\ 
(EC. visibility of element located((By.XPATH, "//span[text() = ' 写 f&']"))) 
# Milit tibl 
element. click() 
# 写 人 收 件 人 地 址 
driver. find element by xpath\ 
("//div[contains((2id,' mail emailinput')]/input").send keys("xxx") 
# GAMER 
driver. find element by xpath\ 
("//div[(?aria- label = ' 邮 件 主题 输入 框 , 请 输入 邮件 主题 ']/input" ). send_keys(u" 新 邮件 ") 
# UA frame 控 作 
driver.switch to.frame(driver.find element by xpath("//iframe[@tabindex=1]")) 
editBox = driver.find element by xpath("/html/body") 
editBox. send keys(u" Z 583€ 9k Z S8 RB — $8 48" ) 
driver.switch to.default content() 
print u" 写 信 完 成 " 
driver.find element by xpath("//header//span[text() = ' 发 送 ']").click() 
print u" 开 始 发 送 邮 件 ..." 
time. sleep(3) 
assert u" 发送 成 功 " in driver.page source 
print u" 邮件 发 送 成 功 ” 
driver.quit() 
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本 节 要 做 的 事 就 是 将 上 面 的 程序 一 步 步 地 改 成 关键 字 驱 动 测试 框架 ,同时 为 发 送 的 邮 
件 增加 附件 。 

关键 字 驱 动 测试 框架 搭建 步骤 : 

(1) 在 PyCharm 工具 中 新 建 一 个 名 叫 KeyWordsFrameWork 的 Python 工程 。 

(2) 在 工程 中 新 建 三 个 Python Package, — H R ,分别 命 名 为 : 

> config 包 , 主 要 用 于 实现 框架 中 各 种 配置 。 

> util f. 主要 用 于 实现 测试 过 程 中 调用 的 工具 类 方法 ,例如 读 取 配置 文件 、 

MapObject `\ 页 面 元 素 的 操作 方法 .解析 Excel 文件 等 。 

> testData 目录 ,主要 用 于 存放 框架 所 需要 的 测试 数据 文件 。 

> testScripts 包 , 用 于 实现 具有 测试 逻辑 的 测试 脚本 。 

G) 在 util 包 中 新 建 ObjectMap. py 模块 ,用 于 实现 定位 页 面 元 素 ,具体 代码 如 下 : 


#encoding= utf - 8 
from selenium. webdriver. support. ui import WebDriverWait 








# NOI CIO XE 
def getElement(driver, locationType, locatorExpression): 
try: 
element = WebDriverWait(driver, 30).untilV 
(lambda x:x.find element(by = locationType, value = locatorExpression)) 
return elenent 
except Exception, e: 
raise e 


# ENCE AT HB IS] CI 2G EXER, 以 list 返回 
def getElements(driver, locationType, locatorExpression): 
try: 
elements = WebDriverWait(driver, 30).untilV 
(lambda x:x.find elements(by = locationType, value = locatorExpression)) 
return elements 
except Exception, e: 


raise e 


if name  -- ' main ': 
from selenium import webdriver 

# timus 

driver = webdriver.Firefox(executable path = "c: Vgeckodriver. exe") 
driver.get("http://www. baidu. com" ) 

searchBox = getElement(driver, "id", "kw") 

# 打印 页 面 对 象 的 标签 名 

print searchBox.tag name 

aList = getElements(driver, "tag name", "a") 

print len(aList) 


driver.quit() 


CD. 在 util 包 中 新 建 一 个 名 叫 WaitUtil py 的 文件 ,用 于 实现 智能 等 待 页 面 元 素 的 出 
现 ,具体 代码 如 下 : 
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# encoding = utf - 8 

from selenium. webdriver. common. by import By 

from selenium. webdriver. support. ui import WebDriverWait 

from selenium. webdriver. support import expected conditions as EC 


class WaitUtil(object): 


def init (self, driver): 
self.locationTypeDict - ( 
"xpath" : By. XPATH, 
"id": By. ID, 
"name" : By. NAME, 
"class_name" : By. CLASS_NAME, 
"tag name": By. TAG NAME, 
"link text": By.LINK TEXT, 
"partial link text": By. PARTIAL LINK TEXT 
) 
self.driver - driver 
self.wait - WebDriverWait(self.driver, 30) 


def frame available and switch to it(self, locationType, locatorExpression): 
"RRE frane 是 否 存 在 ,存在 则 切换 进 Frame fefE rf 
try: 
self.wait.until(EC.frame to be available and switch to it 
( (self. locationTypeDict[locationType.lower()], locatorExpression))) 
except Exception, e: 
# MS BEALEERII 


raise e 


def visibility element located(self, locationType, locatorExpression): 
”"' 显 式 等 任 页 面 元 素 的 出 现 ' 
try: 
element - self.wait.until(EC.visibility of element located 
( (self. locationTypeDict[locationType.lower()], locatorExpression))) 
return element 
except Exception, e: 


raise e 





if name — E pus 
from selenium import webdriver 

driver = webdriver.Chrome(executable path- "c:Wchromedriver") 

driver.get("http://mail.126.com") 

waitUtil - WaitUtil(driver) 

waitUtil.frame available and switch to it("id", "x- URS- iframe") 

e = waitUtil.visibility element located("xpath", "//input[ @name = 'email']") 

e. send keys(" success" ) 

driver.quit() 


C5) 在 util 包 中 新 建 一 个 名 叫 KeyBoardUtil. py 的 Python 文件 ,用 于 实现 模拟 键盘 单 
个 或 组 合 按键 ,具体 内 容 如 下 : 
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# encoding - utf - 8 
import win32api 
import win32con 


class KeyboardKeys(object): 


BL AE BE REDE 

VK CODE = ( 
'enter': Ox0D, 
'ctrl': Ox1l, 
'v': 0x56} 


(à staticmethod 
def keyDown(keyName) : 
# 按 下 按键 
win32api.keybd event(KeyboardKeys.VK CODE[keyName], 0, 0, 0) 


(à staticmethod 
def keyUp(keyNane) : 
# RR 
win32api.keybd event(KeyboardKeys. VK CODE[keyName], 
0, win32con.KEYEVENTF KEYUP, 0) 


(à) staticmethod 

def oneKey(key) : 
# RMAN ERE 
KeyboardKeys. keyDown (key) 
KeyboardKeys. keyUp( key) 


@staticmethod 

def twoKeys(keyl, key2): 
# OBHUIIA HH e RE 
KeyboardKeys. keyDown(keyl1) 
KeyboardKeys. keyDown(key2 ) 
KeyboardKeys. keyUp(key2 ) 
KeyboardKeys. keyUp(keyl ) 


(6) 在 util 包 中 新 建 一 个 名 叫 ClipbeardUtil. py 的 Python 文件 ,用 于 实现 将 数据 设置 
到 剪贴 板 中 ,具体 内 容 如 下 : 


#encoding= utf - 8 
import win32clipboard as w 
import win32con 


class Clipboard( object) : 


FEHI Windows i PE BY Wi c 


# BE M 
(à staticmethod 
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def getText(): 
2M 
w. OpenClipboard() 
# H DY Wi Be dg 
d = w.GetClipboardData(win32con.CF TEXT) 
# XAD 
w. CloseClipboard() 
# i pol JUR te Seti A8 BUT 2E 


return d 


SHERMENT 
(à staticmethod 
def setText(aString): 
# HIFI 
w. OpenClipboard() 
# ED it 
w. EnptyClipboard() 
# 将 数据 aString *j A D Wi 
w. SetClipboardData(win32con.CF UNICODETEXT, aString) 
# Xt 
w. CloseClipboard() 


C7) 在 testScripts 包 中 新 建 一 个 名 叫 TestSendMailWithAttachment. py 的 Python X. 
件 , 用 于 编写 具体 的 测试 逻辑 代码 ,具体 内 容 如 下 : 


#encoding= utf -8 

from util.ObjectMap import * 

from util.KeyBoardUtil import KeyboardKeys 

from util.ClipboardUtil import Clipboard 

from util. WaitUtil import WaitUtil 

from selenium import webdriver 

from selenium. webdriver. common. keys import Keys 
import time 


def TestSendMailWithAttachnent() : 
# 创建 Chrome j| Vi $5 AY 3: [FI 
driver = webdriver.Chrome(executable path = "c:W chromedriver") 
# eK Ied M SE B 
driver.maximize window() 
print u" 启 动 浏览 器 成 功 ” 
print u" 访 问 126 WAERT..." 
driver. get("http://mail. 126.com" ) 
# BE 5E, O fE ABA EE R TE T MR SE 
time. sleep(5) 
assert u"126 网 易 免 费 邮 -- 你 的 专业 电子 邮局 ”in driver. title 
print u" 访 问 126 邮箱 登录 页 成 功 " 


wait = WaitUtil(driver) 

wait.frame available and switch to it("id", "x- URS- iframe") 
print u" 输 入 登录 用 户 名 " 

username = getElement(driver, "xpath", "//input[(Z name = 'email']") 
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username. send keys(" xxx" ) 

print u' 输入 登录 密码 ” 

passwd = getElement(driver, "xpath", "//input[(Z name = 'password']") 
passwd. send keys(" xxx" ) 

Print "ER..." 

passwd. send keys(Keys. ENTER) 

# EIF S Eb, 以 便 登 录 成 功 后 的 页 面 加 载 完 成 

time. sleep(5) 

assert u" 网易 邮箱 ”in driver. title 

print u" 登 录 成 功 " 


element = wait.visibility element located("xpath", "//span[text() = ' 写 信 ']") 
elenent.click() 
printu" Sfi..." 
receiver - getElement(driver, "xpath", 

"//div[contains((àid,' mail emailinput')]/input") 
5i A MC A Hh 
receiver. send keys(" xxx" ) 
subject = getElement(driver, "xpath", 

"//div[(?aria- label = ' 邮 件 主 题 输 入 框 ,请 输入 邮件 主题 ']/input") 
# AMEER 
subject. send_keys(u" 新 邮件 " ) 
zORN-NUEATE 
Clipboard. setText(u" d: Wa. txt" ) 
# ORAE 
Clipboard. getText() 
attachment - getElement(driver, "xpath", 

"// div[contains( @ title, '600 $$ MP3')]") 

# Mili Efe ftl 
attachment.click() 
time. sleep(3) 
# dE EfEBITE Windows f EI PAi Wr D) We fr hy ALTE 
KeyboardKeys. twoKeys("ctrl", "v") 
# BWER, DUAE In 9E E EDS TE 
KeyboardKeys. oneKey(" enter" ) 
# 切换 进 上 邮件 正 文 的 frame 
wait.frame available and switch to it("xpath", "//iframe[ @tabindex = 1]") 
body = getElement(driver, "xpath", "/html/body") 
# 答 人 邮件 正文 
body. send_keys(u" 发 给 光荣 之 路 的 一 封 信 ") 
# 切 出 邮件 正文 的 Frame ffe 
driver.switch to.default content() 
print u" 写 信 完 成 ” 
getElement(driver, "xpath", "//header//span[text() = ' 发 送 ']").click() 
print u" 开 始 发 送 邮 件 .…." 
time. sleep(3) 
assert u" 发 送 成 功 ” in driver.page source 
print u" 邮 件 发送 成 功 ” 
driver.quit() 


if nane — == ' main 


TestSendMailWithAttachnent() 
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代码 解释 : 

将 TestSendMailWithAttachment. py 文件 中 的 “xxx? 改 成 有 效 的 邮箱 地 址 及 密码 , 然 
后 执行 该 文件 ,就 可 以 看 到 浏览 器 自动 登录 126 邮箱 ,并 且 自 动 发 了 一 封 带 有 附件 的 邮件 。 
在 上 面 的 代码 中 可 以 看 到 我 们 将 定位 页 面 元 素 的 方法 ,模拟 键盘 按键 等 封装 成 了 公共 方法 ， 
方便 复 用 ,同时 还 加 入 了 智能 等 待 ,让 UI 自动 化 测试 执行 更 稳定 。 但 上 面 的 代码 仍 未 做 到 
数据 与 程序 的 分 离 ,并且 也 不 能 实现 高 度 复 用 ,由 此 需要 继续 改造 。 

(8) 在 config 包 中 新 建 一 个 名 叫 VarConfig. py 的 Python 文件 ,用 于 定义 整个 框架 中 
所 需要 的 一 些 全 局 常量 值 ,方便 维护 ,具体 内 容 如 下 : 


# encoding = utf - 8 
import os 


ieDriverFilePath = "c:MEDriverServer" 
chromeDriverFilePath = "c:Vchromedriver" 
firefoxDriverFilePath = "c:Vgeckodriver" 


# DI RIEN TE H R MIR A Eg A ERE EG 
parentDirPath = os.path.dirname(os.path.dirname(os.path.abspath( file ))) 
ScreenPicturesDir = parentDirPath + "\\exceptionpictures\\" 


O) 在 util 包 中 新 建 一 个 名 叫 DirAndTime. py 的 Python 文件 ,用 于 获取 当前 日 期 及 
时 间 , 以 及 创建 异常 截图 存放 目录 ,具体 内 容 如 下 : 


#encoding= utf -8 

import time, os 

from datetime import datetime 

from config.VarConfig import screenPicturesDir 


# JOE HJ 
def getCurrentDate() : 
timeTup - time.localtime() 
currentDate = str(timeTup.tm year) + "-" + X 
str(timeTup.tm mon) + "-" + str(timeTup.tm mday) 
return currentDate 


# 菊 肥 当前 的 有 时间 

def getCurrentTine(): 
timeStr = datetime. now() 
nowlime = timeStr.strftime('$H- $M- $S- %f') 
return nowlime 


# 创建 截图 存放 的 月 录 
def createCurrentDateDir(): 
dirName = os.path. join(screenPicturesDir, getCurrentDate()) 
if not os. path. exists(dirName): 
os. makedirs(dirName) 
return dirName 


if name — == ' main 
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print getCurrentDate() 
print createCurrentDateDir() 
print getCurrentTine() 


(10) 修改 util 包 中 的 WaitUtil. py 文件 内 容 如 下 : 


# encoding = utf - 8 

from selenium. webdriver.common.by import By 

from selenium. webdriver. support. ui import WebDriverWait 

from selenium. webdriver. support import expected conditions as EC 


class WaitUtil(object): 


def _ init (self, driver): 
self.locationTypeDict - ( 
"xpath" : By. XPATH, 
"id": By. ID, 
"name" : By. NAME, 
"css selector": By.CSS SELECTOR, 
"class name": By.CLASS NAME, 
"tag name": By. TAG NAME, 
"link text": By. LINK TEXT, 
"partial link text": By. PARTIAL LINK TEXT 
} 
self.driver = driver 
self.wait - WebDriverWait(self.driver, 30) 


def presenceOfElementLocated(self, locatorMethod, locatorExpression, * arg): 
tr Hab CARERE DT ICZ HI PUTE DOM rh, 但 并 不 一 定 可 见 , 
fr f Wis Il ER UR XE I1 
try: 
if self.locationTypeDict.has key(locatorMethod. lower()): 
self.wait.until( 

EC.presence of element located(( 
self.locationTypeDict[locatorMethod. lower()], 
locatorExpression))) 

else: 
raise TypeError(u" 未 找到 定位 方式 ,请 确认 定位 方法 是 否 写 正确 ") 
except Exception, e: 


raise e 


def franeToBeAvailableAndSwitchToIt(self,locationType,locatorExpression, * arg) : 
"ORRE frane 是 否 存 在 ,存在 则 切换 进 frame 控件 中 
try: 
self.wait.until( 

EC.frame to be available and switch to it(( 
self.locationTypeDict[locationType. lower()], 
locatorExpression))) 

except Exception, e: 


e HIE IBALEEIBIISE 
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raisee 


def visibilityOfElementLocated(self, locationType, locatorExpression, * arg): 
"rH CARE BCIBID h HE DOM P, JF H IT A, FFE NE AR RRR 
try: 
self. wait. until( 
EC.visibility of element located(( 
self.locationTypeDict[locationType. lower()], 


locatorExpression))) 
except Exception, e: 
raise e 
if nane  -- ' main ': 


from selenium import webdriver 

driver = webdriver.Chrome(executable path = "c:\\chromedriver" ) 

driver. get("http://mail. 126.com" ) 

waitUtil = WaitUtil(driver) 

waitUtil. frameToBeAvailableAndSwitchToIt("id", "x- URS- iframe") 
waitUtil.visibilityOfElementLocated(" xpath", "//input[(Zname = 'email']") 
waitUtil.presenceOfElementLocated(" xpath" , "//input[(?name- 'email']") 
driver.quit() 


(1D fg KeyWordsFrameWork 工程 中 新 建 一 个 名 叫 action 的 Python package, 并 在 此 
包 中 新 建 一 个 名 叫 PageAction. py 的 Python 文件 ,用 于 实现 具体 的 页 面 动作 ,比如 在 输入 
框 中 输入 数据 , 单 击 页 面 按钮 等 ,具体 内 容 如 下 : 


st encoding - utf -8 

from selenium import webdriver 

from config.VarConfig import ieDriverFilePath 

from config.VarConfig import chromeDriverFilePath 
from config. VarConfig import firefoxDriverFilePath 
from util.ObjectMap import getElement 

from util.ClipboardUtil import Clipboard 

from util.KeyBoardUtil import KeyboardKeys 

from util.DirAndTime import * 

from util.WaitUtil import WaitUtil 

from selenium. webdriver.chrome. options import Options 


import tine 


# 定义 全 局 driver 变量 
driver = None 
E 全 局 的 等 巷 类 实例 对 象 


waitUtil = None 


def open browser(browserName, * arg): 


# FTIF Ò EAE 
global driver, waitUtil 
try: 
if browserName.lower() -- 'ie': 
driver - webdriver.Ie(executable path - ieDriverFilePath) 
elif browserName.lower() -- 'chrome': 
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* 创建 Chrome 浏览 移 的 一 个 Options S ffl xf $e 
chrome options = Options() 
# MÆR —— ignore -certificate - errors 提示 信息 的 设置 参数 项 
chrome options.add experimental option( 
"excludeSwitches", 
[" ignore - certificate - errors"]) 
driver = webdriver.Chronme( 
executable path - chromeDriverFilePath, 
chrome options - chrome options) 
else: 


driver - webdriver.Firefox(executable path - firefoxDriverFilePath) 


# driver Xf & 6| E IF 5, Æ FERK AR 
waitUtil - WaitUtil(driver) 
except Exception, e: 


raise e 


def visit url(url, x arg): 
# 访问 某 个 网 直 
global driver 
try: 
driver.get(url) 
except Exception, e: 
raise e 


def close browser( * arg): 
# XI Eas 
global driver 
try: 
driver.quit() 
except Exception, e: 
raise e 


def sleep(sleepSeconds, * arg): 
E LEES 
try: 
tine. sleep(int(sleepSeconds)) 
except Exception, e: 
raisee 


def clear(locationType, locatorExpression, * arg): 
EOMBRARATERUATIEE 
global driver 
try: 
getElement(driver, locationType, locatorExpression).clear() 
except Exception, e: 


raise e 


def input string(locationType, locatorExpression, inputContent): 


# 在 页 面 答 人 旋 中 输 人 数据 
global driver 


try: 
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getElement(driver, locationType, 
locatorExpression).send keys(inputContent) 
except Exception, e: 
raise e 


def click(locationType, locatorExpression, * arg): 
zou vx 
global driver 
try: 
getElement(driver, locationType, locatorExpression).click() 
except Exception, e: 


raise e 


def assert string in pagesource(assertString, * arg): 

# Bi T MA Nde 5 E Te OG EFRR RE EHE 
global driver 
try: 

assert assertString in driver.page source, V 

u" % s not found in page source!" $assertString 

except AssertionError, e: 

raise AssertionError(e) 
except Exception, e: 

raise e 


def assert title(titleStr, * args): 
* Mi PE D TERA JE S E eI iE M OG RTT HER 
global driver 
teg: 
assert titleStr in driver. title, \ 
u" % not found in title!" %titleStr 
except AssertionError, e: 





raise AssertionError(e) 
except Exception, e: 
raisee 


def getTitle( * arg): 
# 获取 页 面 标 是 
global driver 
try: 
return driver. title 
except Exception, e: 


raise e 


def getPageSource( * arg) : 
# 获取 页 面 源码 
global driver 
try: 
return driver. page_source 
except Exception, e: 
raise e 
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def switch to frame(locationType, frameLocatorExpression, * arg): 


* WHEA frame 
global driver 
try: 
driver.switch to. frame( getElement 
(driver, locationType, frameLocatorExpression)) 
except Exception, e: 
print "frame error" 


raise e 


def switch to default content( * arg): 


# Hih frame 
global driver 
try: 
driver. switch to.default content() 
except Exception, e: 
raise e 


def paste string(pasteString, * arg): 


# Bi Ctrl + V 操作 
try: 
Clipboard. setText(pasteString) 
# OWRF2E, 防止 代码 热 行 得 太 侠 , MR IRD hE ME RE 
time. sleep(2) 
KeyboardKeys. twoKeys(" ctrl", "v") 
except Exception, e: 
raise e 


def press tab key( * arg): 


* 模拟 Tab fd 
try: 

KeyboardKeys. oneKey(" tab" ) 
except Exception, e: 

raise e 


def press enter key( * arg): 


* B Enter fit 
try: 

KeyboardKeys. oneKey(" enter" ) 
except Exception, e: 

raise e 


def maximize browser(): 


# 谷口 最 大 化 
global driver 
try: 
driver.maximize window() 
except Exception, e: 


raise e 


def capture screen( * args): 
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zOEJUEERD 
global driver 
currTime - getCurrentTine() 
picNameAndPath = str(createCurrentDateDir()) + "XM" + str(currTime) + ".png" 
try: 
driver.get screenshot as file(picNameAndPath. replace('\\', r'NV')) 
except Exception, e: 
raise e 
else: 
return picNaneAndPath 


def waitPresenceOfElementLocated(locationType, locatorExpression, * arg): 
Cr Hg CARERE CI TUR HI HETE DOM 中 ,但 并 不 一 定 可 见 ， 
fr fe WR pl RC XE In 

global waitUtil 
try: 

waitUtil.presenceOfElementLocated(locationType, locatorExpression) 
except Exception, e: 

raise e 


def waitFrameToBeAvailableAndSwitchTolt(locationType, locatorExpression, * args): 
"检查 frame 428 fe fk, fe TE H He GE Frame efft" 
global waitUtil 
try: 
waitUtil.frameToBeAvailableAndSwitchToIt(locationType, locatorExpression) 
except Exception, e: 
raise e 


def waitVisibilityOfElementLocated(locationType, locatorExpression, * args): 
Cr He CAE DUI JG R ih PETE DOM P, JF Hon] UL, fe fei Pol iA HUI UR XE In 
global waitUtil 
try: 
waitUtil.visibilityOfElementLocated(locationType, locatorExpression) 
except Exception, e: 


raise e 


(12) 修改 testScripts 包 中 的 TestSendMail WithAttachment. py 文件 内 容 如 下 : 


# encoding - utf - 8 
from action.PageAction import * 
import time 


def TestSendMailWithAttachnent(): 
print u" 启动 chrome 浏览 器 " 
open browser(" chrome") 
maximize browser() 
print u" 访 问 126 邮箱 登录 页 " 
visit url("http://mail.126.com") 
sleep(5) 
assert string in pagesource(u"126 网 易 免 费 邮 -- 你 的 专业 电子 邮局 " ) 
print u" 访问 126 邮箱 登录 页 成 功 ” 
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waitFrameToBeAvailableAndSwitchToIt("id", "x - URS - iframe") 
print u" 输入 登录 用 户 名 " 
input string("xpath", "//input[(Zname- 'email']", "xxx") 
print u" 输 入 登录 密码 " 
input_string("xpath", "//input[(@name = 'password']", "xxx") 
click("id", "dologin") 
sleep(5) 
assert title(u" 网 易 邮 箱 " ) 
print u" FREH" 
waitVisibilityOfElementLocated("xpath", "//span[text() = ' 写 4&']") 
click("xpath", "//span[text() = ' 写 f&']") 
print u" 开始 写 信 " 
print u" 输 入 收 件 人 地 址 ” 
input_string("xpath", 
"//div[contains((?id,' mail emailinput')]/input", 
"xxx" ) 
print u" 输入 邮件 主题 
input string("xpath", 
"//div[(2aria- label = ' 邮 件 主题 输入 框 ,请 输入 邮件 主题 ']/input"， 
新 邮件 ") 
print u" 单 击 上 传 附 件 按 钮 " 
click("xpath", "// div[contains( (@ title, '600 首 MP3')]") 
sleep(3) 
print u" E fẹ ME" 
paste_string(u"d:\\a. txt" ) 
press enter key() 
waitFrameToBeAvailableAndSwitchToIt("xpath", "//iframe[(4tabindex- 1]") 
print u" 写 入 邮件 正文 " 
input string("xpath", "/html/body", u" 发 给 光荣 之 路 的 一 封 信 " ) 
switch to default content() 
print u" 写 信 完 成 ” 
print u" 开 始 发 送 邮 件 ..." 
click("xpath", "//header//span[text() = ' 发 送 ']") 
time. sleep(3) 
assert string in pagesource(u" A 3X X JJ" ) 
print u" 邮件 发 送 成 功 ” 
close browser() 


if name == ' main 


TestSendMailWithAttachment() 


替换 TestSendMailWithAttachment. py 文件 中 的 “xxx? 为 有 效 的 126 邮箱 登录 账号 及 
密码 后 执行 该 文件 ,可 以 看 到 程序 会 自动 启动 Chrome 浏览 器 ,然后 访问 126 邮箱 并 发 送 一 
封 带 附件 的 邮件 。 

(13) 在 util 包 中 新 建 一 个 名 叫 ParseExcel. py 的 Python 文件 ,用 于 实现 读 取 Excel 数 
据 文件 代码 封装 ,具体 内 容 如 下 : 

#encoding= utf - 8 


import openpyxl 
from openpyxl.styles import Border, Side, Font 


. 349 > 


Selenium WebDriver 3.0 一 | 自动 化 测试 框架 实战 指南 


import time 
class ParseExcel(object): 


def init (self): 
self.workbook - None 
self.excelFile - None 
self.font = Font(color = None) £ i£ A F fk ÁIR & 
* BUE ÁY RGB fi 
self.RGBDict = ('red': 'FFFF3030', 'green': 'FF008B00'] 


def loadWorkBook(self, excelPathAndName): 
# 将 Excel XMR PE, JE EIU. workbook 对 条 
try: 
self. workbook = openpyxl. load workbook(excelPathAndName) 
except Exception, e: 
raise e 
self.excelFile - excelPathAndName 
return self. workbook 


def getSheetByName(self, sheetName): 
* MUE sheet 和 名 获取 该 sheet 对 条 
try: 
sheet - self.workbook.get sheet by name(sheetName) 
return sheet 
except Exception, e: 
raise e 


def getSheetByIndex(self, sheetIndex): 
# 根据 sheet H 465] IG sheet x1 $e 
try: 
sheetname = self. workbook. get_sheet_names( ) [ sheetIndex] 
except Exception, e: 
raise e 
sheet = self. workbook. get_sheet_by_name( sheetname) 
return sheet 


def getRowsNumber(self, sheet): 
# EK sheet 中 有 数据 区 域 的 结束 行 号 


return sheet.max row 


def getColsNunber(self, sheet): 
# HIR sheet 中 有 数据 区 域 的 结束 列 号 


return sheet. max_column 
def getStartRowNumber( self, sheet): 
* 获取 sheet 中 有 数据 区 域 的 开 奴 的 行 号 


return sheet. min row 


def getStartColNumber( self, sheet): 
# KIR sheet 中 有 数据 区 域 的 开 妈 的 列 号 
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return sheet.min column 


def getRow(self, sheet, rowNo): 
* 获取 sheet 中 录 一 行 ,返回 的 是 这 一 行 所 有 的 数据 内 众 组 成 的 tuple, 
€ FERM 1 Hth, sheet. rows[1] zs B8 —fT 
try: 
return sheet.rows[rowNo - 1] 
except Exception, e: 


raise e 


def getColumn(self, sheet, colNo): 
* HIR sheet 中 茶 一 列 ,返回 的 是 这 一 列 所 有 的 数据 内 众 组 成 tuple, 
# FERM 1 开始, sheet. columns[1] 表 示 第 一 列 
try: 
return sheet.columns[colNo - 1] 
except Exception, e: 
raise e 


def getCellOfValue(self, sheet, coordinate - None, 
rowNo - None, colsNo - None): 
# REPIN TE o VIE SL ORG P TOME IA, FERA 工 开始 , 
# sheet.cell(row = 1, column = 1).value, 表示 excel «ho — fp 58 — 9I I ff 
if coordinate ! - None: 
try: 
return sheet.cell(coordinate - coordinate).value 
except Exception, e: 
raise e 
elif coordinate is None and rowNo is not None and colsNo is not None: 
try: 
return sheet.cell(row - rowNo, column - colsNo).value 
except Exception, e: 
raise e 
else: 
raise Exception("Insufficient Coordinates of cell !") 


def getCellOfObject(self, sheet, coordinate = None, 
rowNo - None, colsNo - None): 
EON ONE R, AREAK N feo FERT CE SL, 
# 也 可 以 直接 根据 Excel 中 单元 格 的 编码 及 坐标 
# 如 getCellObject(sheet, coordinate = 'A1') or 
4 getCellObject(sheet, rowNo = 1, colsNo = 2) 
if coordinate ! - None: 
try: 
return sheet.cell(coordinate - coordinate) 
except Exception, e: 
raise e 
elif coordinate -- None and rowNo is not None and colsNo is not None: 
try: 
return sheet.cell(row - rowNo,column - colsNo) 
except Exception, e: 


raise e 
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else: 
raise Exception(" Insufficient Coordinates of cell '!") 


def writeCell(self, sheet, content, coordinate - None, 
rowNo - None, colsNo - None, style - None): 
* REPITE Excel PHR ERRA AFRI E n p] TÉ OC PEASE, 
€ FEM 1J 5, 参数 style 表示 字体 的 茵 色 的 名 字 , 比如 red, green 
if coordinate is not None: 
try: 
sheet. cell(coordinate = coordinate).value = content 
if style is not None: 
sheet. cell(coordinate = coordinate). \ 
font = Font(color = self. RGBDict[ style] ) 
self. workbook. save( self. excelFile) 
except Exception, e: 
raise e 





elif coordinate == None and rowNo is not None and colsNo is not None: 


try: 
sheet.cell(row = rowNo,column = colsNo).value = content 
if style: 
sheet. cell(row = rowNo, column = colsNo).V 
font = Font(color = self. RGBDict[ style] ) 
self. workbook. save( self. excelFile) 
except Exception, e: 
raise e 
else: 
raise Exception(" Insufficient Coordinates of cell !") 


def writeCellCurrentTime(self, sheet, coordinate = None, 
rowNo = None, colsNo = None): 
8 SA PERO REIR, FERM 工 开始 
now = int(time.time()) 并 显示 为 上 时间 惟 
timeArray = time.localtime(now) 
currentTime = time.strftime(" $Y- %m- %d %H: $M: $S", tineArray) 
if coordinate is not None: 
try: 
sheet.cell(coordinate - coordinate).value - currentTime 
self. workbook. save(self.excelFile) 
except Exception, e: 
raise e 
elif coordinate == None and rowNo is not None and colsNo is not None: 
try: 
sheet.cell(row - rowNo, column - colsNo). value - currentTime 
self. workbook. save(self.excelFile) 
except Exception, e: 
raise e 
else: 
raise Exception(" Insufficient Coordinates of cell !") 


if name — == ' main 
pe = ParseExcel() 
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# 测 试 所 用 的 Excel 文件 "126 邮箱 联系 人 . xlsx" 请 自行 创 建 
pe. loadWorkBook(u'D: \\PythonProject\\126 邮箱 联系 人 .xlsx') 
print "通过 名 称 获取 sheet 对 象 的 名 字 :"，pe. getSheetByName(u" 联 系 人 "). title 
print "通过 index 序号 获取 sheet 对 象 的 名 字 : ", pe.getSheetByIndex(0).title 
sheet = pe.getSheetByIndex(0) 
print type(sheet) 
print pe.getRowsNumber(sheet) £C A XT 
print pe.getColsNumber(sheet)  £ JJ Jg X 9 
rows = pe.getRow(sheet, 1) # 获取 第 一 行 
for i in rows: 
print i.value 
# 获取 第 一 行 第 一 列 单 元 杉 内 容 
print pe.getCellOfValue(sheet, rowNo = 1, colsNo = 1) 
pe.writeCell(sheet, u' 我 爱 祖 国 ', rowNo = 10, colsNo = 10) 
pe.writeCellCurrentTime(sheet, rowNo - 10, colsNo - 11) 


(14) 在 testData 目录 中 新 建 一 个 名 叫 "126 邮箱 发 送 邮 件 . xlsx” 的 Excel 文件 ,并 在 此 
Excel 文件 中 新 建 三 个 工作 表 , 分 别 命名 为 “测试 用 例 “ 登 录 ” 及 “发 邮件 ”。 
“测试 用 例 ” 工 作 表 用 于 存放 测试 用 例 , 内 容 如 表 15-3 所 示 。 








表 15-3 
序号 用 例 名 称 用 例 描述 步骤 sheet 名 | 是 否 执行 | 执行 结束 时 间 | 结果 
号 登录 126 
1 ORG 126 邮箱 使 用 有 效 的 账号 登录 126 gm " 
邮箱 
pa ”| 登录 126 邮箱 后 ,发 送 一 " 
2? | 发 送 带 附件 的 邑 件 | 封 带 附件 的 邮件 WE D 




















epi pu ag y” Ao ARR HI BIS EDU n ORAT o 
“登录 "工作 表 用 于 存放 登录 126 邮箱 的 所 有 步骤 信息 ,内 容 如 表 15-4 所 示 。 

















表 15-4 
操作 测试 测 | 错 | 错 
序 元 素 的 | 操作 元 素 的 -| 试 | 误 | 误 
2 测试 步骤 描述 关 键 字 定位 mmu 操作 值 结 | 信 | 蕉 
方式 果 | 息 | 图 
1 | 打开 浏览 器 open browser chrome 
访问 被 测试 网 址 http:// 
2 |http://www. visit url www. 
126. com 126. com 
3 | 最 大 化 窗口 maximize_browser 
等 待 126 邮箱 登录 sleep 5 
主页 加 载 完 成 
断言 当前 活动 页 面 126 网 易 
; W p REGN GL Ap assert string _ in 免费 邮 - - 
”|*126 网 易 免 费 邮 - -| pagesource 你 的 专业 
你 的 专业 电子 邮局 ” 电子 邮局 
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ET 
操作 测试 测 | 错 | 错 
序 元 素 的 | 操作 元 素 的 -| 试 | 误 | 误 
号 测试 步骤 描述 关 键 字 定位 定位 表达 式 操作 值 xd alela 
方式 果 | 息 | 图 
显 式 等 待 id 属性 值 
为 x URSiframe 的 | waitFrameToBe 
6 |frame 框 的 出 现 , 然 | Available id x-URS-iframe 
后 切换 进入 该 frame| AndSwitchToIt 
框 中 
P //input[@ name 
7 | 输入 登录 用 户 名 input_string xpath . XXX 
—'email' | 
8 | 输入 登录 密码 input_string xpath //input[@name Xxx 
zz (pasivord] 
9 | 单 击 登录 按钮 click id dologin 
10 | 等 竺 slecp 5 
switch to default 
11 | 切 回 默认 会 话 窗 体 
_content 
断言 登录 成 功 后 的 
12 eleluiisicididdl assert title EN 
“网 易 邮箱 6.0 版 ” E 6. 0 版 
关键 内 容 
“发 邮件 ?工作 表 用 于 存放 登录 成 功 后 ,发送 邮件 所 有 步骤 信息 ,内 容 如 表 15-5 所 示 。 


























表 15-5 
操作 测试 测 | 错 | 错 
序 测试 元 素 的 操作 元 素 的 _| 试 | 误 | 误 
号 | sss *95* | 定位 | erraz 。 | 操作 值 ud alela 
方式 果 | 息 | 图 
判断 “ 写 信 ” 
| waitVisibilityOf //span 
是 
1 | 按 n E54 ElementLocated saah [textO =' 5S f] 
页 面 上 可 见 
y fmt T iek pagi, | conn 
按钮 [text()=' 写 信 "] 
SARER. | / iv Lcomains id," 
3 input string xpath | mail _ emailinput '|xxx 
地 址 
) ]/input 
/ / div[ @ aria-label = ' 
i 2 dr xpath | 邮件 主题 输入 框 ,请 输 "eue 
! 入 邮件 主题 ']/input 
Wah" EN | // div [contains ( @ 
5 click xpath | . 
件 " 链 接 title, '600 首 MP3')] 
6 3 ARE BE aste strinj d: Wa. txt 
在 绝对 路 径 | me 
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续 表 





序 测试 元 素 的 操作 元 素 的 
号 | ”步骤 描述 e) Liu 定位 定位 表达 式 ux sam 


3 35 Bo 


Wr op mi iè 
B] Bb oi on 





模拟 键盘 回 
T press enter key 


车 键 





显 式 等 待 附 | waitVisibilityOf //span[ text O =" E f£ 
件 上 传 完毕 “| ElementLocated | 777 | 完成 中 





HERNE waitFrameToBe 


f /fi 
9 sa ipis Available xpath le i zi 
EI AndSwitchTolt TOMAS 
进 该 frame 中 





发 给 光荣 
输入 邮件 正文 | input_string xpath |/html/body 之 路 的 一 
封 信 





退出 邮件 正 | switch to default 
文 的 frame _content 

12 单 击 邮件 发 dick ssh / / header/ /span 
送 按钮 [textO —' 3X '] 
等 待 邮 件 发 
13 | 送 成 功 ,返回 | sleep 3 
结果 

断言 页 面 源 
码 中 是 否 出 | assert _ string _in —- 
a 现 “ 发 送 成 | _pagesource 发 送 成 功 
功 "关键 内 容 
15 | 关闭 浏览 器 。” | close browser 






































说 明 : 

“登录 ”和 “发 邮件 ”工作 表 中 的 “关键 字 ” 列 内 容 对 应 action 包 中 PageAction. py 文件 中 
的 函数 名 ;“ 操 作 元 素 定位 方式 列 " 表 示 定 位 页 面 元 素 所 使 用 的 定位 方式 ,比如 xpath id $; 
“操作 元 素 定位 表达 式 ? 列 ,表示 定位 页 面 元 素 所 使 用 的 定位 方式 对 应 的 定位 表达 式 ;“ 操 作 
值 " 列 ,表示 页 面 输入 框 需要 输入 的 内 容 、 断 言 函数 需要 的 关键 内 容 等 。 

“测试 用 例 ” 工 作 表 中 的 “序号 "和 “用 例 描述 "以 及 用 例 步 骤 表 中 的 “序号 "不 作为 关键 字 
驱动 框架 使 用 的 列 , 因 此 可 以 不 填 . 但 这 些 列 必须 存在 ,并 且 表 格 的 顺序 不 能 改变 ,如 果 不 想 
要 这 两 列 ,可 以 将 其 删除 ,或 者 修改 了 上 面 几 张 表格 的 顺序 ,需要 在 config 包 中 的 
VarConfig. py 文件 中 ,同步 更 新 一 下 框架 中 用 到 的 各 个 工作 表 中 的 列 的 数字 编号 。 

从 数据 表 的 设计 可 以 看 出 ,程序 中 使 用 的 定位 表达 式 及 操作 值 不 再 与 代码 混合 在 一 起 ， 
如 果 定 位 方式 、 定 位 表达 式 或 者 操作 值 有 变化 ,只 需要 修改 数据 文件 中 相关 内 容 即 可 ,不 仅 
方便 维护 ,还 可 以 让 不 懂 代 码 的 测试 人 员 实 现 自动 化 测试 ,提高 了 自动 化 测试 的 效率 。 
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(15) 修改 config 包 中 的 VarConfig. py 文件 内 容 如 下 : 


# encoding = utf - 8 
import os 


ieDriverFilePath = "c:\IEDriverServer" 
chromeDriverFilePath = "c:\chromedriver" 
firefoxDriverFilePath = "c:\geckodriver" 


# Tfj XFN TE A RHR H RMIX EE 
parentDirPath = os.path.dirname(os.path.dirname(os.path.abspath( file _))) 


9B REITER HRÍBXES IS 


ScreenPicturesDir = parentDirPath + "WMVexceptionpictures V" 


# 测试 数据 文件 存放 缩 对 路 径 
dataFilePath = parentDirPath + u"\\testData\\126 邮箱 发 送 邮 件 .xlsx" 


# 测试 数据 文件 中 ,测试 用 例 表 中 部 分 列 对 应 的 数字 序号 
testCase testCaseName = 2 

testCase testStepSheetName - 4 

testCase isExecute - 5 

testCase runTime - 6 

testCase testResult - 7 


# 用 例 步 紧 表 中 ,部 分 列 对 应 的 数字 序号 
testStep_testStepDescribe = 2 
testStep_keyWords = 3 
testStep_locationType = 4 
testStep_locatorExpression = 5 
testStep operateValue = 6 

testStep runTime - 7 

testStep testResult - 8 

testStep errorInfo - 9 

testStep errorPic - 10 


(16) 修改 testScripts 包 中 TestSendMail WithA ttachment, py 文件 内 容 如 下 : 


#encoding= utf - 8 

from action. PageAction import * 

from util. ParseExcel import ParseExcel 
from config. VarConfig import * 

import time 

import traceback 


# 设置 此 次 测试 的 环境 编码 为 utf8 
import sys 

reload(sys) 

sys. setdefaultencoding("utf - 8") 


# OSEE DT Excel 对 条 
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excel0bj = ParseExcel() 


# 将 Excel 数据 文件 加 载 到 内 存 
excelObj. loadWorkBook(dataFilePath) 


# MARAE RRITAR Fs, 向 Excel rh HA TIATR f 
def writeTestResult(sheetObj, rowNo, colsNo, testResult, 
errorInfo - None, picPath - None): 
# 测试 通过 结 扣 信息 为 绿色 ,失败 为 红色 
colorDict = ("pass":"green", "faild":"red"} 


# AH "WH A" TERKA" HAER sheet "PABA W HAITA A 
# 测试 结 打 列 ,定义 此 字典 对 象 是 为 了 区 分 具体 应 该 写 哪个 工作 表 
colsDict = { 
"testCase":[testCase runTime, testCase testResult], 
"caseStep" :[testStep runTime, testStep testResult]] 
try: 
# WEIR sheet 中 , 写 人 测试 时间 
excel0bj. writeCellCurrentTime(sheetObj, 
rowNo = rowNo, colsNo = colsDict[colsNo][0]) 
# EMHI sheet rfi, GA WAAR 
excel0bj. writeCell( sheetObj, content = testResult, 
rowNo = rowNo, colsNo = colsDict[colsNo][1], 
style = colorDict[testResult]) 
if errorInfo and picPath: 
# 在 测试 步 又 sheet H, GARR AE 
excel0bj. writeCell( sheetObj, content = errorInfo, 
rowNo = rowNo, colsNo = testStep errorInfo) 
# 在 测试 步 对 sheet P, G A B CILE GG 
excel0bj.writeCell(sheetObj, content = picPath, 
rowNo = rowNo, colsNo = testStep errorPic) 
else: 
# EWAH sheet rf, lp S EE i BAT 
excelO0bj.writeCell(sheetObj, content = "", 
rowNo - rowNo, colsNo - testStep errorInfo) 
# EMAER sheet rh, 洲 空 异常 信息 单元 棚 
excelObj.writeCell(sheetObj, content = "", 
rowNo - rowNo, colsNo - testStep errorPic) 
except Exception, e: 
print u" 5j excel 出 错 ,",， traceback.print exc() 


def TestSendMailWithAttachnent() : 
try: 
# R Excel 文件 中 的 sheet 名 获取 sheet 对 条 
caseSheet = excel0bj.getSheetByName(u" 测 试用 例 ") 
# 获取 测试 用 例 sheet 中 是 否 热 行列 对 条 
isExecuteColumn = excelObj.getColumn(caseSheet, testCase isExecute) 


# 记录 热 行 成 功 的 测试 用 锐 个 数 


SuccessfulCase = 0 
# 记录 需要 执行 的 用 例 个 数 
requiredCase = 0 
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for idx, i in enumerate( isExecuteColumn[1:]): 

# BI fil sheet 中 第 一 行为 标题 行 ,无 须 执行 

# print i.value 

# 所 环 访 历 "测试 用 例 " 表 中 的 测试 用 例 , DUET EE PE Do DUET BO HIE A 

if i.value.lower() == "y": 
requiredCase *- 1 
# 获取 "测试 用 例 " 表 中 第 idx + 2 行 数据 
caseRow = excelObj.getRow(caseSheet, idx + 2) 
# 获取 第 idx*2 FFA" sheet" V GC ME PITE 
caseStepSheetName = caseRow[testCase testStepSheetName - 1]. value 
# print caseStepSheetName 


EONUEIILPBIETE RREI sheet 对 条 
stepSheet = excelObj.getSheetByName(caseStepSheetName) 
# RHR sheet rp Je 
stepNum = excelObj. getRowsNunber(stepSheet) 
# print stepNum 
# 记录 测试 用 例 工 的 步 儿 成 功 数 
successfulSteps = 0 
print u" 开始 执行 用 例 " % s"" \ 
% caseRow[testCase testCaseName — 1].value 
for step in xrange(2, stepNum * 1): 
# AHER sheet 中 的 第 一 行为 标题 行 ,无 须 执 行 
# KREI sheet 中 第 step 行 对 象 
stepRow = excelObj.getRow(stepSheet, step) 
# KRRP MA WM IR CS 
keyWord = stepRow[testStep keyWords — 1].value 
# 获 友 操作 元 素 害 万 方 式 作为 凋 爵 的 函数 的 参数 
locationType = stepRow[testStep locationType - 1].value 
E DERMEE hY ut 0 RE IA CES BUM e C E 
locatorExpression = stepRow[testStep locatorExpression - 1].value 
# HIRME IEJ BUM IR EUM 3€ 


operateValue - stepRow[testStep operateValue - 1].value 


EOMEHBHEI UU ECE 2E 09 DECIR PE ICE fb BRA, p Fl FIF B EE 
if isinstance(operateValue, long): 
operateValue - str(operateValue) 
£ print keyWord, locationType, locatorExpression, operateValue 
expressionStr - "" 
# 构造 需要 执行 的 python 语句 ， 
# 对 应 的 是 PageAction. py 文件 中 的 页 面 动作 函数 凋 用 的 字符 毕 表 示 
if keyWord and operateValue and V 
locationType is None and locatorExpression is None: 
expressionStr = keyWord.strip() + "(u'" *operateValue *"')" 
elif keyWord and operateValue is None and V 
locationType is None and locatorExpression is None: 
expressionStr - keyWord.strip() * "()" 
elif keyWord and locationType and operateValue and V 
locatorExpression is None: 
expressionStr - keyWord.strip() * V 
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"('" + locationType.strip() *"', u'" *operateValue t "')" 
elif keyWord and locationType and locatorExpression V 
and operateValue: 
expressionStr - keyWord.strip() * V 
"('" + locationType.strip() + "', " + \ 
locatorExpression.replace(" '", '"').strip() + V 
"', u'" + operateValue + "')" 
elif keyWord and locationType and locatorExpression V 
and operateValue is None: 
expressionStr - keyWord.strip() * V 
"('" + locationType.strip() + "', " + V 
locatorExpression. replace(" '", '"').strip() + "')" 
# print expressionStr 
try: 
# 通过 eval RC, 44 DEH h VIRES TE ER CURL II E PRR 
# 当成 有 效 的 Python Ei 3CPUT, M iI WARAY sheet 中 
* 关键 宇 在 ageaction. py 文 作 中 对 应 的 映射 方法 ， 
# 来 完成 对 页 面 无 素 的 操作 
eval(expressionStr) 
# 在 测试 执行 时 间 列 写 人 执行 时 间 
excelObj.writeCellCurrentTime( 
stepSheet, rowNo - step, 
colsNo - testStep runTime) 
except Exception, e: 
# RIA RA ELA 
capturePic = capture screen() 
# UEM OE HIE 
errorInfo = traceback.format exc() 
# 在 测试 步 绎 Sheet 中 写 人 失败 信息 
writeTestResult( 
stepSheet, step, "caseStep", 
"faild", errorInfo, capturePic) 
print u" PPR" * s" 执行 失 败 !”\ 
% stepRow[testStep testStepDescribe - 1].value 
else: 
# 在 测试 步 紧 Sheet 中 写 人 成 功 信息 
writeTestResult(stepSheet, step, "caseStep', "pass") 
# 每 成 功 一 步 , successfulSteps W dd E] Ji 1 
successfulSteps += 1 
print u" 步 又 " % s" 执 行 通过 !"\ 
% stepRow[testStep testStepDescribe - 1].value 
if successfulSteps -- stepNum - 1: 
# MPHXJH PIE JE sheet 中 所 有 的 步 绎 者 执行 成 功 ,， 
E 方 认为 此 测试 用 例 执行 通过 ,然后 将 成 功 信 息 写 人 
# 测试 用 例 工作 表 中 ,否则 写 人 失败 信息 
writeTestResult(caseSheet, idx + 2, "testCase", "pass") 
successfulCase += 1 
else: 
writeTestResult(caseSheet, idx * 2, "testCase", "faild") 
print u" # $ d RAB, sd 条 需要 被 执行 , 本 次 执行 通过 sd 条.”\ 
% (len(isExecuteColumn) — 1, requiredCase, successfulCase) 
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except Exception, e: 
# 因 印 举 细 的 异常 俊 配 信息 
print traceback. print_exc() 


if name == ' main ': 
` TestSendMailWithAttachnent( ) 
(17) 在 KeyWordsFrameWork 工程 根 目 录 中 创建 一 个 名 叫 RunTest. py 的 Python X 
件 , 用 于 实现 关键 字 框 架 运 行 的 入 口 代码 ,具体 内 容 如 下 : 


#encoding= utf -8 
from testScripts. TestSendMailWithAttachment import TestSendMailWithAttachment 


if name  -- ' main ': 
TestSendMailWithAttachment() 
C180 将 数据 文件 “126 邮箱 发 送 邮件 . xlsx” 中 的 各 表格 “操作 值 ” 列 中 的 “xxx” 改 成 有 效 
的 邮箱 账号 及 密码 ,然后 在 PyCharm 中 执行 RunTest. py 文件 ,可 以 看 到 程序 自动 打开 了 
浏览 器 ,并 发 送 了 一 封 带 附件 的 邮件 ,执行 结果 如 图 15-14 所 示 。 









C:\Python27\python. exe D: /PythonProject /KeyWordsFrameWork/RunTest. py 
gp TUEAGRD "Bios" 

步骤“ 打开 浏览 器 ”执行 通过 | 
S3 。 步 对 “访问 祯 测试 网 址 http://am_ 126. con” 执行 通过 ! 
Bl san” 执行 通过 ! 
Q 。 步 可 “等 待 126 邮 箱 登录 主页 加 载 完成 ”执行 适 过 1 
o SN “ 断 训 当 前 活 南面 大 码 中 是 否 包含 "126 网易 免 费 邮 一 你 的 专业 电子 邮局 ”” 执 行 通过 

步骤 “ 显 式 等 待 id 属 性 值 为 x-URS-iframe 的 frame 杠 的 出 现 ， 然 后 切换 进入 该 二 me 框 中 ”执行 通过 ! 
步 票 “输入 登录 用 户 名 ”执行 通过 ! 
步骤 “输入 登录 密码 ”执行 通过 ! 
PR “ 单 击 登录 按钮 ”执行 通过 ! 
HB pe" 执行 通过 1 
步骤 “断言 痘 录 成 功 后 的 页 面 标题 是 否 包含 “网易 邮箱 5. of" ARAE” 执行 通过 1 
开始 执行 用 例 “发送 邮 件 ” 
JOH mE" 按钮 是 否 在 页 面 上 可 见 ” 执 行 通 过 ! 
BH ubt mis" 按钮” 执行 通过 | 
步骤 “输入 收 件 人 地 址 ”执行 通过 ! 
步 慰 “输入 邮件 主题 ”执行 通过 ! 
SR Ad“ HERE” BE” 执行 通过 1 
步 票 “ 输 入 附件 所 在 绝对 路 径 ” 执 行 通过 ! 
SR “模拟 键盘 回 车 刍 ” 执行 通过 ! 
步 票 “显示 等 待 附件 上 传 完成 ”执行 通过 ! 
步 敢 “如果 邮 件 正文 的 frame 框 是否 可 见 ， 切 按 进 该 红 ame 中 ”执行 通过 ! 
步骤 “输入 邮件 正文 ”执行 通过 ! 
步 票 “退出 邮件 正文 的 frane” 执 行 通过 ! 
IB “ 单 击 邮件 发 送 按钮 ” 执行 通过 1 
UB “等 待 邮件 发 送 成 功 ， 近 回 结果 ”执行 通过 ! 
HS “断言 页 面 源码 中 是 否 出 现 “发送 成 功 ”关键 内 容 ” 执 行 通过 | 

"Hd : 788 


"xwIiEzmvt 


SOR. GEREGHAG. FAATERE. 
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上 面 我 们 只 是 把 测试 过 程 及 结果 总 结 信息 输出 到 控制 台 , 但 不 方便 错误 的 排查 以 及 后 
期 结果 信息 的 查看 ,为 此 我 们 加 入 打印 日 志 功能 。 

(19) 通过 logging 模块 ,为 关键 字 驱 动 框架 加 入 打印 日 志 功能 。 在 config 包 中 新 建 一 
个 名 叫 Logger. conf 的 文件 ,用 于 配置 日 志 基 本 信息 ,具体 内 容 如 下 : 


# logger. conf 

HPHRHRRHRRERRRRRRHRRHEHEHHHHHHHHEHEHEHERHERRHEH 
loggers] 

keys = root, example01, example02 

logger_root] 

level = DEBUG 

handlers = hand01, hand02 


logger_example01] 
handlers = hand01, hand02 
qualname = example01 
propagate = 0 





logger_example02] 
handlers = hand01, hand03 
qualname = example02 
propagate = 0 


Log LL LL CL L LLL EHE Ep LLL EI 
[handlers] 
keys = hand01, hand02, hand03 


[handler hand01] 
class - StreanHandler 
level = INFO 
formatter - form01 
args = (sys. stderr, ) 


[handler hand02] 

class - FileHandler 

level - DEBUG 

formatter - form01 

args = ('logWMMaill26TestLogfile.log', 'a') 


[handler hand03] 

class - handlers. RotatingFileHandler 

level = INFO 

formatter - form01 

args = ('logWMMaill26TestLogfile. log', 'a', 10 * 1024 * 1024, 5) 


BBBBBDBUBUSDPSSUSSUSUSUUSPPESEUBUBSBBSBEBUBEDBBBBBBAR 
[formatters] 


keys = form01, form02 


[formatter form01] 
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format = % (asctime)s % (filename)s[line: % (lineno)d] % (levelname)s % (message)s 
datefmt- $Y- $m- %d SH: M: S 


[formatter form02] 
format = % (name)- 12s: % (levelname) -8s % (message)s 
datefmt = $Y- $m- $d SH: $M: $S 


(20) f£ util 包 中 新 建 一 个 名 叫 Log. py 的 Python 文件 ,用 于 初始 化 日 志 对 象 ,具体 内 
容 如 下 : 





# encoding = utf - 8 

import logging 

import logging.config 

from config. VarConfig import parentDirPath 


eH BUB XÍE 

logging. config.fileConfig(parentDirPath + u"\config\Logger. conf" ) 
# ETE BMC 

logger = logging.getLogger(" example02" ) # f/f example01 


def debug(nmessage) : 


# 定义 dubug 级 别 日 志 打 印 方法 
logger. debug( message) 


def info(message): 


# ENX info 级别 日 志 打 印 方法 


logger. info(message) 


def warning(message): 
# 定义 warning ZI H TT EU Zr i 
logger. warning( message) 


(21) f£ DataDrivenFrameWork 工程 根 目录 下 创建 一 个 名 叫 log 的 目录 ,然后 修改 
testScripts 包 中 的 TestSendMailWithAttachment. py 文件 的 内 容 如 下 : 


# encoding = utf - 8 

from action.PageAction import * 

from util.ParseExcel import ParseExcel 
from config. VarConfig import * 

import time 

import traceback 

from util. Log import * 


# 变 置 此 次 测试 的 环境 编码 为 utf -8 
import sys 

reload(sys) 

sys. setdefaultencoding("utf - 8") 


* 创建 解析 Excel 对 条 


excel0bj = ParseExcel() 
# 将 Excel 数据 文件 加 载 到 内 存 
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excel0bj. loadWorkBook(dataFilePath) 


# ARAE PETIT IA COR, 向 Excel rH TIAE E 
def writeTestResult(sheetObj, rowNo, colsNo, testResult, 
errorInfo - None, picPath - None): 
# 测试 通过 结 扶 信息 为 绿色 , 失败 为 红色 
colorDict = ("pass":"green", "faild":"red"} 


# AX "WH A" TERA" HAER sheet 表 " 中 部 有 测试 执行 时 间 和 
# 测试 结 黑 列 , 定义 此 字典 对 条 是 为 了 区 分 具 亿 应 该 写 哪 个 工作 表 
colsDict = ( 
"testCase":[testCase runTime, testCase testResult], 
"caseStep":[testStep runTime, testStep testResult]] 
try: 
# EMER sheet rfi, 写 人 测试 有 时间 
excelObj.writeCellCurrentTime(sheetObj, 
rowNo - rowNo, colsNo - colsDict[colsNo][0]) 
# EWH sheet H, GA WAAR 
excelO0bj.writeCell(sheetObj, content = testResult, 
rowNo = rowNo, colsNo = colsDict[colsNo][1], 
style = colorDict[testResult]) 
if errorInfo and picPath: 
# 在 测试 步 坚 sheet rh, GAH E (EL 
excelObj.writeCell(sheetObj, content - errorInfo, 
rowNo = rowNo, colsNo = testStep errorInfo) 
# EWER sheet rh, G A JP iE IIS BERG 
excel0bj.writeCell(sheetObj, content = picPath, 
rowNo - rowNo, colsNo - testStep errorPic) 
else: 
# 在 测试 步 紧 sheet rh, lr 5 SE fi BATE 
excel0bj.writeCell(sheetObj, content = "", 
rowNo = rowNo, colsNo = testStep errorInfo) 
# WHR sheet th, HSH A A BAT 
excelO0bj.writeCell(sheetObj, content = "", 
rowNo = rowNo, colsNo = testStep_errorPic) 
except Exception, e: 
# EHEM GAMS BS BE 
logging. debug(u" 写 excel tH $$, % s" $ traceback.format exc()) 


def TestSendMailWithAttachnent() : 
try: 
# R Excel 文件 中 的 sheet 名 获取 sheet 31 
caseSheet = excelObj.getSheetByName(u" jill i A H" ) 


# 获取 测试 用 例 sheet 中 是 否 热 行列 对 条 
isExecuteColumn = excelObj.getColumn(caseSheet, testCase isExecute) 
# ode fir D PIT C 
successfulCase - 0 
# 记录 需要 执行 的 用 例 个 数 
requiredCase = 0 
for idx, i in enumerate( isExecuteColumn[1:]): 
# Bil sheet 中 第 一 行为 标题 行 ,无 须 执行 
# print i. value 


# MFRS "W A AK P A AH A, DUET BIETER TAE KG AA RI 
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if i.value.lower() -- "y": 
requiredCase *- 1 
# 获取 "测试 用 例 " 表 中 第 idx € 2 行 数据 
caseRow = excel0bj. getRow(caseSheet, idx + 2) 
# 获取 第 idx 2 rH" pF sheet" yit A 
caseStepSheetName = caseRow[testCase testStepSheetName - 1]. value 
# print caseStepSheetName 


# ORUETIPIESE SL EERUP IE sheet 对 条 

stepSheet = excelObj.getSheetByName(caseStepSheetName) 

# IRER sheet PHRA 

stepNum = excelObj. getRowsNumber(stepSheet) 

# print stepNum 

# 记录 测试 用 例 3 MAP HEIDI EC 

successfulSteps - 0 

logging. info(u F tA HiT FH BI" $ s"" 
% caseRow[testCase testCaseName - 1].value) 

for step in xrange(2, stepNum * 1): 
# AHER sheet 中 的 第 一 行为 标题 行 ,无 须 执 行 
# RINER sheet 中 第 step 行 对 条 
stepRow = excel0bj. getRow( stepSheet, step) 
# KRKE MA WAH h RA 
keyWord = stepRow[testStep keyWords — 1].value 
# HIRME E fo Ir AME J WA KY mM gd 
locationType = stepRow[testStep locationType - 1]. value 
# KIREK IE [o REIN CIE IBI PR CI 3€ 
locatorExpression = stepRow[testStep locatorExpression - 1].value 
# OIGRETEIW TES IM IR UM E 


operateValue = stepRow[testStep operateValue - 1].value 





E HEIRE ES BPR HII EFE FIF BRA, y fl FIF B EIE 
if isinstance(operateValue, long): 
operateValue = str(operateValue) 
# print keyWord, locationType, locatorExpression, operateValue 
expressionStr = "" 
# fiim ET python 语句 ， 
# Xj Pageaction.py X fF If W Il zh TF PR R TTG 7 f eB es 
if keyWord and operateValue and V 
locationType is None and locatorExpression is None: 
expressionStr = keyWord.strip() + "(u'" *operateValue *"')" 
elif keyWord and operateValue is None and V 
locationType is None and locatorExpression is None: 
expressionStr - keyWord.strip() * "()" 
elif keyWord and locationType and operateValue and V 
locatorExpression is None: 
expressionStr - keyWord.strip() * V 
"('" + locationType.strip() +"', u'" + operateValue t "')" 
elif keyWord and locationType and locatorExpression V 
and operateValue: 
expressionStr - keyWord.strip() * V 
"('" + locationType.strip() + "', '" + V 
locatorExpression.replace(" ", '"').strip() + V 


,u'" + operateValue + "') 
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elif keyWord and locationType and locatorExpression V 
and operateValue is None: 
expressionStr - keyWord.strip() * V 
"('" + locationType.strip() + "', ™ + \ 
locatorExpression. replace(" '", '"').strip() + "')" 
£ print expressionStr 
try: 
* 通过 eval JC, 44 BEHE A DT H S TE PR CURL FBR 
# 当成 有 效 的 Python KAI HIT, M MAITEK sheet 中 
# 关键 字 在 ageAction. py XPFP xt Wl 4t 7r, 
# 来 完成 对 页 面 无 素 的 操作 
eval(expressionStr) 
# 在 测试 热 行 时 间 列 写 人 热 行 时 间 
excel0bj. writeCellCurrentTime( 
stepSheet, rowNo = step, 
colsNo - testStep runTime) 
except Exception, e: 
E MI K RERA 
capturePic - capture screen() 
# Un s WE HB 
errorInfo - traceback.format exc() 
# 在 测试 步 又 Sheet 中 写 人 失败 信息 
writeTestResult( 
stepSheet, step, "caseStep", 
"faild', errorInfo, capturePic) 
logging. info(u" 步骤" $% s" 执 行 失 败 ， 错 误 信 息 : Ss" 
% (stepRow[testStep testStepDescribe - 1]. value, 
errorInfo)) 
else: 
# 在 测试 步 坚 Sheet 中 写 人 成 功 信 息 
writeTestResult(stepSheet, step, "caseStep", "pass") 
# 每 成 功 一 步 , successfulSteps Wit AIÑ 1 
successfulSteps += 1 
logging. info(u" 3p WR" % s" 执 行 通过 !" 
% stepRow[testStep testStepDescribe - 1].value) 
if successfulSteps -- stepNum - 1: 
# GWAA AEIR sheet f PETIERE HEIL IT MID, 
# 方 认为 此 测试 用 例 执 行 通 过 ,然后 将 成 功 信 息 写 人 
# 测试 用 例 工作 表 中 ,否则 写 人 失败 信息 
writeTestResult(caseSheet, idx + 2, "testCase", "pass") 
successfulCase += 1 
else: 
writeTestResult(caseSheet, idx * 2, "testCase", "faild") 
logging. info(u" 3t % d RAPI, sd 条 需要 被 执行 ,本 次 执行 通过 $d 条 .” 
% (len(isExecuteColumn) — 1, requiredCase, successfulCase)) 
except Exception, e: 
5TH EE HT 
print traceback.print exc() 


(22) 运行 RunTest. py 文件 ,执行 结束 后 可 以 在 工程 目录 下 的 Log 目录 中 看 到 打印 的 
日 志文 件 Maill26TestLogfile. log, 文 件 所 包含 的 内 容 如 图 15-15 所 示 , 这 里 只 粗略 地 打印 
了 一 些 执行 过 程 信息 ,读者 可 以 添加 更 加 详细 的 日 志 信息 ,以 便 查 看 更 详细 执行 过 程 逻辑 ， 
便于 测试 执行 中 过 程 的 问题 分 析 及 过 程 监控 。 
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43 TestSendai INL thhttachsent. py[line:73] DPO THASRITRIM "ERNER" 
47 TestSendilai IWi thàttachment. py[line:145] IFO F$ “HANNS” 执行 通过 ! 
T T 48. TestSendiisi Wi thAttachsent. pr1ine:145] INFO FE " 5 [B] HERE ERIAE nt tp: //mm. 126. ccm” 执行 通过 | 
-17 16:16:49 TestSendilai IWi tht tachsent. py[1ine:145] IMPO P$ "最 大 化 调 口 ”执行 通过 ! 
-17 16:16:54 TestSendlisi li thAttachsent. py[line:145] INFO 2:88 " Wisi RE E MRE” RTA 
54 TestSendilsi IWi thÀt tachsent. py[line:145] JD $38 "IKE SIE Sh WRWATEEEÉ "i14 REB —insdiacras Sn "trit 
54 TestSendilai IWi thAt rachzent. py[1ine:145) INO 步骤 " 7-5 Hi lS 5 RS- frame frame EER, EREA frase Ee" ATAL! 
54 TestSendilai Wi thAttochsent. py[1ine:145] INFO FW “GARRAFA” ATAT! 
55 TestSendiisi IWi thAt tachsent. py1ine:145] TWO E "BRA" triti 
55 TestSendilai IWi thAttachment. py[line:145] IMO $88 "BA" RTE 
00 TestSendilai lWi th&ttachment. py[ine:145] INFO PW “WS” HiT! 
01. TestSendilai IWi thAttachzent. py[line:145] IMO £08 "EBANOGSETREBEZES “ABEE oM" Xm" nili 
01 TestSendilai IWi thAttachzent. py[1ine:73] IMPO 开始 执行 用 例 "发送 邮件 ” 
04 TestSendilai Ii thAttochsent. py[line:145] IMO $38 "NN "IE" PURESTREUA" ATAL 
04 TestSendilai IWi thAttachsent. pr[1ine:145] IFO FW “at “WA” a” AA! 
05 TestSendilai IWi thAttachsent. py[line:145] IFO SY "MA MEA iE" AFET 
07 TestSendilai Wi thAttachsent. py[line:145] INFO $8 "A BEER" 扶 行 通过 | 
(08 TestSendilai IWi thÀt tachment. py[15ne:145] INFO FW “AT “ERRE” (ERU ATT! 
10 TestSendilai Wi tht tachsent. py[line:145] INFO FI “WARNERS” AA! 
31 TestSendilai IWi thAt tachsent. prline:145] IWO PW "SIIMABAW" ATEN! 
11. TestSendllsi Ii thAt rochzent. py[line:145] INFO PW" EUT-WASIE PE ERE" RTIAI! 
12 TestSendllai INi thAt tachsent. py [line:145] INFO SIE “HRPE Eram EDT. UD fret" Dri! 
12 TestSendilai IWi thAt tachsent. py[line:145] IPO B "LA BERGE " AFET 
12 TestSendilai IWi thàt techsent. py[1ine:145) INFO PW “BESHE rome " 执行 通过 ! 
13 TestSendliai IWi thhttachsent. py[line:145] TWO FI " jt E AN ERG" AAT 





16 TestSendilai Wi thAt tachsent. py[1ine:145] INFO $48 "phat toon. ERAR” ATIMI! 

16 TestSendlisi IWi thAttechment. py[line:145) INFO f£ "WANEFSHESER "PERH" RENAE” friki 
19 TestSendlisi IWi thAttachsent. py[1ine:145] INO 2:88 " RP EE" HA ril 

20 TestSendilai Wi thAttachsent. py[11ne:155) INFO ARMM. 2B MIL. EAIMTARTON. 


图 15-15 


* EVER: 
在 TestSendMailWithAttachment. py X ff 





D KeyWordsFrameWork D:\PythonProjed 





中 每 个 try 和 except 的 语句 块 中 均 添 加 了 打印 日 Y ton i 
志 的 语句 ,这 样 可 以 实现 在 测试 执行 结束 后 , 通 m 3 
过 查看 日 志 信 息 来 查看 测试 执行 的 过 程 信息 及 | vme 
异常 详细 信息 ,以 便 定位 错误 。 同时 测试 数据 d rms d 
*126 邮箱 发 送 邮 件 . xlsx" 文 件 中 ,分 别 在 每 个 测 用 区 varconfgpy 
试用 例 后 面 及 用 例 步骤 后 面 写 信 了 本 次 执行 成 ”| 7 Damen 
功 与 否 的 信息 、 异 常 信息 及 发 生 异 常 页 面 的 截图 v D2007-117 
路 径 及 名 称 。 由 于 篇 幅 所 限 , 这 里 就 不 再 给 出 数 | 。 EX NR 
据 文件 的 截图 。 -日 Nanz6restooflelog 
至 此 ,关键 字 驱 动 测试 框架 全 部 搭建 完成 ， 
在 PyCharm 工具 中 ,整个 工程 的 结构 如 图 15-16 | 7 "as 
Bron. [È TestSendMailWithAttachment.py 
关键 字 驱 动 测试 框架 比 数据 驱动 框架 更 加 |” PP 
高 级 ,可 以 进一步 提高 自动 化 测试 工作 实施 的 效 [è ClipboardUtiLpy 
率 ,其 具体 特点 如 下 "psa id 
OD 使 用 外 部 测试 数据 文件 ,使 用 Excel 管理 Bo AME 
测试 用 例 的 集合 和 每 个 测试 用 例 的 所 有 执行 测 B Pasetxcelpy 关键 字 驱 动 框架 
试 步骤 ,实现 在 一 个 文件 中 完成 测试 用 例 的 维护 | [naim ALI 





Tff. 
Q) 每 个 测试 用 例 的 测试 结果 可 以 在 一 个 文 15-16 
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件 中 查看 和 统计 。 

C) 通过 定义 关键 字 、 操 作 元 素 的 定位 方式 及 定位 表达 式 和 操作 值 就 可 以 实现 每 个 测试 
步骤 的 执行 ,可 以 更 加 灵活 地 实现 自动 化 测试 的 需求 。 

@ 实现 定位 表达 式 和 测试 代码 的 分 离 ,实现 定位 表达 式 直 接 在 数据 文件 中 进行 维护 。 

C) 框架 提供 日 志 功能 ,方便 调试 和 监控 自动 化 测试 程序 的 执行 。 

© 基于 关键 字 测 试 框架 ,即使 不 懂 开 发 技术 的 测试 人 员 也 可 以 实施 自动 化 测试 ,便于 
在 整个 测试 团队 中 推广 和 使 用 自动 化 测试 技术 ,降低 自动 化 测试 实施 的 技术 门槛 。 

D 基于 关键 字 的 方式 ,可 以 进行 任意 关键 字 的 扩展 ,以 满足 更 加 复杂 项 目的 自动 化 测 








15.4 关键 字 叹 数据 混合 驱动 框架 及 实战 





在 前 面 我 们 完成 了 数据 驱动 框架 及 关键 字 驱 动 框架 的 搭建 ,但 在 实际 工作 中 , 仍 可 能 出 
现 不 满足 测试 需求 的 情况 ,因此 本 节 我 们 将 实践 把 数据 驱动 和 关键 字 驱 动 框架 整合 到 一 起 ， 
搭建 一 个 关键 字 6.8. 数据 混合 驱动 框架 。 

本 节 实 战 的 被 测试 功能 是 登录 126 邮箱 、 批 量 添加 联系 人 及 发 送 一 封 带 附件 的 邮件 。 

非 混合 框架 时 向 126 邮箱 添加 联系 人 及 发 邮件 测试 代码 : 


# encoding =utf -8 

from selenium import webdriver 

from selenium. webdriver. common. keys import Keys 

from selenium. webdriver. common. by import By 

from selenium. webdriver. support. ui import WebDriverWait 

from selenium. webdriver. support import expected conditions as EC 


import time 


print u" 启 动 浏览 器 ..." 

# 创建 Chrome W V de KI X [P] 

driver = webdriver.Chrome(executable path = "c: W chromedriver") 

# eK eN E SE BIET 

driver.maximize window() 

print u" 启 动 浏览 器 成 功 ” 

print u" 访 问 126 邮箱 登录 页 ..." 

driver.get("http: //mail.126. com") 

# BEES Fh, 以便 邮箱 登录 页 面 加 载 完成 

time. sleep(5) 

assert u"126 网 易 免 费 邮 -- 你 的 专业 电子 邮局 ”in driver. title 

print u" 访 问 126 邮箱 登录 页 成 功 " 

# 创建 星 式 等 待 

wait = WebDriverWait(driver, 30) 

# KE id X x- URS- iframe 的 frame Je 15 ff ft, f£ fk W H Hait frame t fF 
wait. until(EC. frame to be available and switch to it((By. ID, "x- URS- iframe") ) ) 
# GOUHLP ddl A E 

userName = driver.find element by xpath('//input[(Z name = "email"]') 
£ÁBAHPE 


userName. send keys(" xxx" ) 
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# Ki AHE 

pwd = driver. find element by xpath(" //input[(4 name = 'password']") 

# AM 

pwd. send keys(" xxx" ) 

# 发 送 一 个 向 车 键 

pwd. send keys(Keys. RETURN) 

print wj AXESR..." 

# OSEE 5 Fb, LA MERE GR D Jer HU CIE CHE IC 

time. sleep(5) 

assert u" 网易 邮箱 "in driver. title 

print u" 登录 成 功 ” 

print u" 添 加 联系 人 ..." 

A CAE REGHTUR fi BE T THT JG ZE IO HUE 

addressBook - wait.until(EC.visibility of element located 
( (By. XPATH, "//div[text() = 'iB iR '1"))) 

# qul limo "EL 

addressBook. click() 

# OEE EKR A Fe HL PE 

newContact - wait.until(EC.visibility of element located 
( (By. XPATH, "//span[text() = ' 新 建 联系 人 ']"))) 

8n RERA 

newContact. click() 


E MERMA BUR A fih AREH HL 
contactName = wait.until(EC.visibility of element located 
( (By. XPATH, 
"//a[@title = ' 编 辑 详细 姓名 ' ]/preceding - sibling: :div/input"))) 
contactName. send keys(u" lily") 
# MAKRA TAH 
driver. find_element_by_xpath( 
"// * [@id= 'iaddress MAIL wrap']//input" 
).send keys(u" lily(4 qq. com") 
driver.find element by xpath( 
"//span[text() = 'i& 25 E bx Bk A À. ' ]/ preceding - sibling: :span/b" 
).click() 
# 给 人 联系 人 手机 号 
driver.find element by xpath( 
"// * [(2id- 'iaddress TEL wrap']//dd//input" ).send keys("185xxxxxx") 
# 得 人 备注 信息 
driver. find element by xpath("//textarea").send keys(u' Bb A") 
# ou "Ue 
driver. find element by xpath("//span[text() = ' 确 3E ']"). click() 
time. sleep(2) 
assert "lily@qq. com" in driver. page source 
print u" 添加 联系 人 成 功 ” 


print u" 进入 首页 " 

driver.find element by xpath('//div[. = "首页 "]').click() 
print u" 548..." 

# BREGI E fe hE te W ICR ÁY h HE 


element = wait. until(EC. visibility of element located 
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( (By. XPATH, "//span[text() = '5 4&'1"))) 
# Miti fa ttt 
element. click() 
5S AMT AIDE 
driver.find element by xpath( 
"//div[contains((Z)id,' mail emailinput')]/input" 
). send keys(" xxx(à)qq. com" ) 
# GAMER 
driver.find element by xpath( 
"//div[@aria - label = ' 邮 件 主题 输入 框 , 请 输入 邮件 主题 ']/input" 
) . send keys(u" 光 荣 之 路 " ) 
# Uit frane fff 
driver. switch to.frame(driver.find element by xpath(" //iframe[(Gtabindex- 1]")) 
editBox = driver.find element by xpath("/html/body") 
editBox.send keys(u" 发 给 光荣 之 路 的 一 封 信 ") 
driver.switch to.default content() 
print u" 写 信 完 成” 
driver. find element by _xpath("//header//span[text() = ' 发 送 ']").click() 
print u" 开 始 发 送 邮 件 ..." 
time. sleep(3) 
assert u" 发 送 成 功 ”in driver. page source 
print um 邮件 发 送 成 功 " 
driver.quit() 


本 节 将 把 上 面 的 测试 程序 ,一步 步 地 改造 成 关键 字 8.6. 数据 驱动 混合 框架 模式 ,同时 
为 发 送 的 邮件 增加 附件 。 

关键 字 8-8 数据 混合 驱动 测试 框架 搭建 步骤 ， 

(1) 在 PyCharm 工具 中 新 建 一 个 名 叫 KeyWordAndDataDrivenFrameWork 的 Python 
工程 。 

(2) 在 工程 中 新 建 三 个 Python Package, 一 个 目录 ,分别 命名 为 : 

> config 包 , 用 于 实现 框架 中 各 种 配置 信息 。 

> util 包 , 用 于 实现 测试 过 程 中 调用 的 工具 类 或 方法 ,例如 读 取 配置 文件 .MapObiject、 

页 面 元 素 的 操作 方法 .解析 Excel 文件 等 。 

> testData 目录 ,用 于 存放 框架 所 需要 的 测试 数据 文件 。 

> testScripts 包 , 用 于 实现 具有 测试 逻辑 的 测试 脚本 。 

G) 在 util 包 中 新 建 ObjectMap. py 模块 ,用 于 实现 定位 页 面 元 素 ,具体 代码 如 下 : 


#encoding= utf - 8 
from selenium. webdriver. support. ui import WebDriverWait 


# IK X CX XER 
def getElement(driver, locationType, locatorExpression): 
try: 
element - WebDriverWait(driver, 30).until( 
lambda x: x.find element(by = locationType, value = locatorExpression)) 
return element 
except Exception, e: 


raise e 
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# EHE BIS] CI CR XE, 以 list iR [o] 
def getElements(driver, locationType, locatorExpression): 
try: 
elements - WebDriverWait(driver, 30).until( 
lambda x:x.find elements(by = locationType, value = locatorExpression)) 
return elenents 
except Exception, e: 
raise e 
if name  -- ' main ': 
from selenium import webdriver 
# 进行 单元 测试 
driver = webdriver.Firefox(executable path="c:\geckodriver.exe") 
driver. get("http://www. baidu. con" ) 
searchBox - getElement(driver, "id", "kw") 
# 打印 页 而 对象 的 标签 名 
print searchBox.tag name 
aList - getElements(driver, "tag name", "a") 
print len(aList) 
driver.quit() 


CD. f£ util 包 中 新 建 一 个 名 叫 WaitUtil. py 的 文件 ,用 于 实现 智能 等 待 页 面 元 素 的 出 


现 , 具 体 代码 如 下 : 


#encoding= utf -8 

from selenium. webdriver. common. by import By 

from selenium. webdriver. support. ui import WebDriverWait 

from selenium. webdriver. support import expected conditions as EC 


class WaitUtil(object): 
EON tonus 
def init (self, driver): 
self.locationTypeDict - ( 
"xpath" : By. XPATH, 
"id": By. ID, 
"name" : By. NAME, 
"ess selector": By.CSS SELECTOR, 
"class name": By. CLASS NAME, 
"tag name": By. TAG NAME, 
"link text": By. LINK TEXT, 
"partial link text": By. PARTIAL LINK TEXT 
) 
£ NÁLdriver 对 条 
self.driver - driver 
# Og d CR RESEBIAEAR 


self.wait - WebDriverWait(self.driver, 30) 
def presenceOfElementLocated(self, locatorMethod, locatorExpression, x arg): 


"BRG RIR HAE DOM 中 ,但 并 不 一 定 可 见 。 
存在 刚 返 回访 页面 元 素 对 条 
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try: 
if self. locationTypeDict. has_key(locatorMethod. lower ( ) ) : 
element = self. wait. until( 

EC. presence of element located(( 
self.locationTypeDict[locatorMethod. lower()], 
locatorExpression))) 

return element 
else: 
raise TypeError(u" 未 找到 定位 方式 ,请 确认 定位 方法 是 否 写 正确 ") 
except Exception，e: 
raise e 


def frameToBeAvailableAndSwitchToIt(self, locationType, locatorExpression, * args): 
"RRR frame 428 ff fe, fF TE WU] P XE frame 控件 中 
try: 
self.wait.until( 
EC.frame to be available and switch to it(( 
self.locationTypeDict[locationType.lower()], 
locatorExpression))) 
except Exception, e: 
# MS BA ERK 


raise e 


def visibilityOfElementLocated(self, locationType, locatorExpression, * args): 
"EIE SEFE CIBC Hi PUTE DOM rh, JE Ho TI o, fe dei NZI ORE tn 1 
try: 
element = self.wait.until( 

EC.visibility of element located(( 
self.locationTypeDict[locationType. lower()], 
locatorExpression))) 

return element 
except Exception, e: 


raise e 


if nane — == ' main ': 
from selenium import webdriver 

driver = webdriver.Chrome(executable path = "c: chromedriver" ) 

driver. get(" http://mail.126.con") 

waitUtil = WaitUtil(driver) 
waitUtil.frameToBeAvailableAndSwitchToIt("id", "x- URS- iframe") 
waitUtil.visibilityOfElementLocated("xpath" , "//input[(2name = 'email']") 


driver.quit() 
C5) 在 util 包 中 新 建 一 个 名 叫 ClipboardUtil. py 的 Python 文件 ,用 于 实现 剪贴 板 功 
能 ,具体 内 容 如 下 : 


# encoding = utf - 8 
import win32clipboard as w 
import win32con 
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class Clipboard(object): 


FEHI Windows 1 EZ 9 Wi Bc 
# BURN 
(à staticmethod 
def getText(): 
# HAT RE 
w. OpenClipboard() 
# HO Wi eb Seg 
d = w.GetClipboardData(win32con.CF TEXT) 
# XAD 
w. CloseClipboard() 
# iB PID Me BEC A RTT E 


return d 


ERN 

(à staticmethod 

def setText(aString): 
# TIER 
w. OpenClipboard() 
Eo» 
w. EnptyClipboard() 
# 将 数据 astring * A JW 
w. SetClipboardData(win32con.CF UNICODETEXT, aString) 
# XAD 
w. CloseClipboard( ) 


(6) 在 util 包 中 新 建 一 个 名 叫 KeyBoardUtil. py 的 Python 文件 ,用 于 实现 模拟 键盘 按 
键 功能 代码 ,具体 内 容 如 下 : 


# encoding- utf - 8 
import win32api 
import win32con 


class KeyboardKeys(object) : 


BULL BE Te f 28 


VK COD = ( 
'enter': 0x0D, 
'ctrl': 0x11, 
'v': 0x56} 


@staticmethod 
def keyDown(keyNane) : 
# 按 下 按键 
win32api. keybd_event (KeyboardKeys. VK_CODE[keyName], 0, 0, 0) 


@staticmethod 
def keyUp(keyNane) : 
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# Hut 
win32api.keybd event(KeyboardKeys.VK CODE[keyName], 
0, win32con. KEYEVENTF KEYUP, 0) 


(à staticmethod 

def oneKey(key) : 
# BULYCIERE 
KeyboardKeys. keyDown(key) 
KeyboardKeys. keyUp(key) 


(à staticmethod 

def twoKeys(keyl, key2): 
# 模拟 两 个 组 台 键 
KeyboardKeys. keyDown(key1 ) 
KeyboardKeys. keyDown(key2 ) 
KeyboardKeys. keyUp(key2 ) 
KeyboardKeys. keyUp(keyl ) 


(7) 在 testScripts 包 中 新 建 一 个 名 叫 TestSendMailWithAttachment. py 的 Python X 
件 , 用 于 实现 具体 的 测试 巡 辑 代码 ,具体 内 容 如 下 : 


# encoding = utf - 8 

from util.ObjectMap import * 

from util.KeyBoardUtil import KeyboardKeys 

from util.ClipboardUtil import Clipboard 

from util. WaitUtil import WaitUtil 

from selenium import webdriver 

from selenium. webdriver.common.keys import Keys 
import time 


def TestSendMailWithAttachnent(): 
# 创建 Chrome 浏览 稀有 的 实例 
driver = webdriver.Chrome(executable path = "c:\\chromedriver") 
# ek ied SE BIUI 
driver.maximize window() 
print u" 启 动 浏览 器 成 功 " 
print u" 访 问 126 WAERT..." 
driver. get("http://mail. 126.com" ) 
EHE SF, A fE ABAE ER DT TAT A ER E IC 
time. sleep(5) 
assert u"126 网 易 免费 邮 -- 你 的 专业 电子 邮局 ”in driver. title 
print u" 访 问 126 邮箱 登录 页 成 功 " 


wait = WaitUtil(driver) 

# WIP id="x- URS- iframe" HHE ih PL, J OJ tai Z 
wait.frameToBeAvailableAndSwitchToIt("id", "x- URS- iframe") 

print u" 输 入 登录 用 户 名 " 

username = getElement(driver, "xpath", "//input[@name = 'email']") 
username. send keys(" xxx" ) 

print u' 输入 登录 密码 ” 

passwd = getElement(driver, "xpath", "//input[(Z name = 'password']") 
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passwd. send keys(" xxx" ) 

print u" 登录 ..." 

passwd. send keys(Keys. ENTER) 

# 等 荐 5 E, LA MERE F A DH AE CIRCE HE 

time. sleep(5) 

assert u" 网易 邮箱 ”in driver. title 

print u" 登录 成 功 " 

print u" 添 加 联系 人 ..…" 

# dg CAE REGB TUR fib Bt VUIBI TUR IO HL 

addressBook = wait.visibilityOfElementLocated(" xpath", 
"//div[text() = 'iB iR 3 ']") 

# gulli oe br 

addressBook.click() 

E EEIEIEE ZR A EIU HL 

newContact = wait.visibilityOfElementLocated(" xpath" , 
"/span[text() = ' 新 建 联系 人 ']") 

# OH ERREUR AE 

newContact.click() 

E MERNE AKRA HER A HE H H 

contactName = wait.visibilityOfElementLocated( 

"xpath", "//a[(Gtitle = ' 编 辑 详细 姓名 ' ]/preceding - sibling: :div/input") 
contactName. send keys("lily") 
email = getElement(driver, "xpath", "// » [(Zid- 'iaddress MAIL wrap']//input") 
email.send keys("lily(4 qq. com") 

EORR EKXXA 
getElement(driver, "xpath", 

"//span[text() = ' 设 为 星 标 联系 人 ' ]/Preceding - sibling::span/b").click() 
mobile = getElement(driver, "xpath","// » [ @id = 'iaddress TEL wrap']//dd//input") 
# 输 人 联系 人 手机 号 
mobile.send keys("183xxxxxxx" ) 

# 给 人 备注 信息 
getElement(driver, "xpath", "//textarea" ). send_keys(u" 朋 友 ") 
# Mih" ibat "PEEL, BR EEBOR A 
getElement(driver, "xpath","//span[text() = ' 确 定 ']").click() 
time. sleep(1) 
assert u" lily@qq.com" in driver.page source 
print u" 添加 联系 人 成 功 " 
time. sleep(2) 
getElement(driver, "xpath", '//div[. =" 首 页 " ]').click() 
element = wait.visibilityOfElementLocated("xpath", "//span[text()=' 写 信 ']") 
element.click() 
print u" 写 信 ..." 
receiver = getElement(driver, "xpath", 
"//div[contains((Zid,' mail emailinput')]/input") 

# f A MCA IE 
receiver.send keys("xxx") 
subject = getElement(driver, "xpath", 

"//div[ (9 aria - label = ' 邮 件 主题 输入 框 ,请 输入 邮件 主题 ' ] /input") 
# HABIE 
subject. send keys(u" 新 邮件 " ) 
# BRDA 
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Clipboard. setText(u" d: \\a. txt" ) 
# HDA 
Clipboard. getText() 
attachment = getElement(driver, "xpath", 
"// div[contains( (? title, '600 # MP3')]") 
# qul ETC TEREBE 
attachment.click() 
time. sleep(3) 
# dE EfEITE Windows JR EI rM Wi D9 WE B P hg AE 
KeyboardKeys. twoKeys(" ctrl", "v") 
# RERE, DUAE ICE E fE hE 
KeyboardKeys. oneKey(" enter" ) 
# UMASEIETTIE X Hj frame 
wait.frameToBeAvailableAndSwitchTolt(" xpath", "//iframe[(Gtabindex- 1]") 
body = getElement(driver, "xpath", "/html/body") 
# 输入 邮件 正文 
body. send_keys(u" 发 给 光荣 之 路 的 一 封 信 " ) 
# 切 册 时 伯 正文 的 Frame HE 
driver. switch to. default content() 
print u" 写 信 完 成" 
getElement(driver, "xpath", "//header//span[text() = ' 发 送 ']").click() 
print u" 开 始 发 送 邮 件 .…." 
time. sleep(3) 
assert u" 发送 成 功 " in driver.page source 
print u" 邮 件 发 送 成 功 ” 
driver. quit() 


if name  -- ' main ': 
TestSendMailWithAttachment() 
代码 解释 : 


将 TestSendMailWithAttachment. py 文件 中 的 “xxx? 改 成 有 效 的 邮箱 地 址 及 密码 , 然 
后 执行 该 文件 ,就 可 以 看 到 浏览 器 自动 登录 126 邮箱 ,然后 添加 一 个 联系 人 ,并 且 自 动 发 了 
一 封 带 有 附件 的 邮件 。 在 上 面 的 代码 中 可 以 看 到 我 们 将 定位 页 面 元 素 的 方法 、 模 拟 键 盘 按 
键 等 封装 成 了 公共 方法 ,方便 复 用 ,同时 还 加 入 了 智能 等 待 , 让 UI 自动 化 测试 执行 更 稳定 。 
但 上 面 的 代码 还 并 未 实现 数据 驱动 .关键 字 驱 动 ,为 此 我 们 需要 继续 改造 。 

(8) 在 config 包 中 新 建 一 个 名 叫 VarConfig. py 的 Python 文件 ,用 于 定义 整个 框架 中 
所 需要 的 一 些 全 局 常量 值 ,方便 维护 ,具体 内 容 如 下 : 


# encoding - utf - 8 
import os 


ieDriverFilePath = "c:MEDriverServer" 
chromeDriverFilePath = "c:Wchromedriver" 
firefoxDriverFilePath = "c: Vgeckodriver" 


# HANKIN ARR A RHA RE GG 

parentDirPath = os.path.dirname(os.path.dirname(os.path.abspath( file ))) 
# 异常 图 片 存放 月 录 

ScreenPicturesDir = parentDirPath + "\\exceptionpictures\\" 
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(9) 在 util 包 中 新 建 一 个 名 叫 DirAndTime. py 的 Python 文件 ,用 于 获取 当前 日 期 及 
时 间 , 以 及 创建 异常 截图 存放 目录 ,具体 内 容 如 下 : 


# encoding - utf -8 

import time, os 

from datetime import datetime 

from config. VarConfig import screenPicturesDir 





# H iih H 
def getCurrentDate(): 
timeTup = time.localtime() 
currentDate = str(timeTup.tm year) + "-" + \ 
str(timeTup. tm mon) + "-" + str(timeTup.tm mday) 


return currentDate 


# AH G Bip ug 

def getCurrentTine(): 
timeStr = datetime. now() 
nowTime = timeStr.strftime('$ H- $M- $S- %f') 
return nowTime 


# Oti feum Hog 
def createCurrentDateDir(): 
dirName = os.path. join(screenPicturesDir, getCurrentDate()) 
if not os. path. exists(dirName): 
os. nakedirs(dirName) 
return dirName 
if name  -- ' main ': 
print getCurrentDate() 
print createCurrentDateDir() 
print getCurrentTime() 


(10) 在 KeyWordsFrameWork 工程 中 新 建 一 个 名 叫 action 的 Python package. Jf- E ilt 
包 中 新 建 一 个 名 叫 PageAction. py 的 Python 文件 ,用 于 实现 具体 页 面 动 作 的 封装 ,比如 在 
输入 框 中 输入 数据 , 单 击 页 面 按钮 等 ,具体 内 容 如 下 : 


# encoding = utf - 8 

from selenium import webdriver 

from config. VarConfig import ieDriverFilePath 

from config. VarConfig import chromeDriverFilePath 
from config. VarConfig import firefoxDriverFilePath 
from util.ObjectMap import getElement 

from util.ClipboardUtil import Clipboard 

from util.KeyBoardUtil import KeyboardKeys 

from util.DirAndTime import * 

from util.WaitUtil import WaitUtil 

from selenium. webdriver. chrome. options import Options 
import time 
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# 定义 全 局 driver 变量 
driver = None 


# 全 局 的 等 符 类 实例 对 和 象 


waitUtil = None 


def open browser(browserName, * arg): 


# FTIN EAE 
global driver, waitUtil 
try: 
if browserName. lower() == 'ie': 
driver = webdriver. Ie(executable_path = ieDriverFilePath) 
elif browserName.lower() == 'chrome': 


# 创建 Chrome 浏览 带 的 一 个 Options SE [IX] e 
chrome options - Options() 
# mR -- ignore- certificate - errors 提示 信息 的 设置 参数 项 
chrome options.add experimental option( 
"excludeSwitches", 
[" ignore - certificate - errors" ]) 
driver - webdriver.Chrome( 
executable path = chromeDriverFilePath, 
chrome options - chrome options) 
else: 
driver - webdriver.Firefox( 
executable path = firefoxDriverFilePath) 
# driver 对 条 创建 成 功 后 , Ol sb E RAE SE Ee 
waitUtil = WaitUtil(driver) 
except Exception, e: 
raise e 


def visit url(url, x arg): 
# UA IAE 
global driver 
try: 
driver.get(url) 
except Exception, e: 


raise e 


def close browser( * arg): 
# XI 
global driver 
try: 
driver.quit() 
except Exception, e: 
raise e 


def sleep(sleepSeconds, * arg): 
# LET 
try: 
time. sleep( int(sleepSeconds)) 
except Exception, e: 


raise e 
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def clear(locationType, locatorExpression, * arg): 
# 清除 给 人 礁 默 认 内 和 众 
global driver 
try: 
getElement(driver, locationType, locatorExpression).clear() 
except Exception, e: 


raise e 


def input_string(locationType, locatorExpression, inputContent) : 
# ATRAE RA GET 
global driver 
try: 
getElement(driver, locationType, 
locatorExpression).send keys(inputContent) 
except Exception, e: 
raise e 


def click(locationType, locatorExpression, * arg): 
5 nul Wlocs 
global driver 
try: 
getElement(driver, locationType, locatorExpression).click() 
except Exception, e: 
raise e 


def assert string in pagesource(assertString, * arg): 
# Biz BUR 4E P e M OC HET XE EFIR 
global driver 
try: 
assert assertString in driver.page source, V 
u" % s not found in page source!" 5 assertString 
except AssertionError, e: 





raise AssertionError(e) 
except Exception, e: 


raise e 


def assert title(titleStr, x args): 

* HrEEPU E PST fe I E M OC HE HER 
global driver 
try: 

assert titleStr in driver. title, V 

u" % not found in title!" 5titleStr 

except AssertionError, e: 

raise AssertionError(e) 
except Exception, e: 

raise e 


def getTitle( * arg): 


# DD B b 
global driver 
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try: 
return driver. title 

except Exception, e: 
raise e 


def getPageSource( * arg) : 
# EHOW BE S 
global driver 
try: 
return driver. page source 
except Exception, e: 


raise e 
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def switch to frame(locationType, frameLocatorExpression, * arg): 


# UHÁASEA frame 
global driver 
try: 
driver. switch_to. frame(getElement 


(driver, locationType, frameLocatorExpression)) 


except Exception, e: 
print "frame error" 
raise e 


def switch to default content( * arg): 
# Hih frame, [e] f FETA Xf is fte P 
global driver 
try: 
driver.switch to.default content() 
except Exception, e: 
raise e 


def paste string(pasteString, * arg): 
# BE Ctrl + VPE 
try: 
Clipboard. setText(pasteString) 


# GIF 2 Bb, BE IELCRRDAT EA He, E A CULA 


time. sleep(2) 
KeyboardKeys. twoKeys(" ctrl", "v") 
except Exception, e: 


raise e 


def press tab key( * arg): 
* BH Tab f 
try: 
KeyboardKeys. oneKey(" tab" ) 
except Exception, e: 
raise e 


def press enter key( * arg): 


£ Bi Enter f 
try: 
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KeyboardKeys. oneKey(" enter" ) 
except Exception, e: 


raise e 


def maximize browser(): 
# 窗口 最 大 化 
global driver 
try: 
driver.maximize window() 
except Exception, e: 


raise e 


def capture screen( * args): 
# OUAIS 
global driver 
# GENUINE, Fd SU ER 
currTime - getCurrentTine() 
* DEEH M EIH RTF HHRH REIER H Fk 
picNameAndPath = str(createCurrentDateDir()) + "\\" + str(currTime) +". png" 
try: 
# OWOROEREIS HL HRPE II E He XIF 
driver.get screenshot as file(picNameAndPath. replace('\\', r'\\')) 
except Exception, e: 
raise e 
else: 
return picNameAndPath 


def waitPresenceOfElementLocated(locationType, locatorExpression, * arg): 
"rH CARERE CI CR Hi HU fe DOM 中 ,但 并 不 一 定 可 见 ， 
ff E MIR el iB UR ER I| 
global waitUtil 
try: 
waitUtil.presenceOfElementLocated(locationType, locatorExpression) 
except Exception, e: 


raise e 


def waitFrameToBeAvailableAndSwitchTolt(locationType, locatorExpression, * args): 
"RRE frane EEH fe, fe TE UI Ta UE frame fff pnt" 
global waitUtil 
try: 
waitUtil.frameToBeAvailableAndSwitchToIt(locationType, locatorExpression) 
except Exception, e: 


raise e 


def waitVisibilityOfElementLocated(locationType, locatorExpression, * args): 
EEIE ICR ih PETE DOM P, JE Hon] UL, fe dei Pli A IU RE Inn 
global waitUtil 
try: 
waitUtil.visibilityOfElementLocated(locationType, locatorExpression) 
except Exception, e: 


raise e 
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(11) 修改 testScripts 包 中 的 TestSendMailWithAttachment. py 文件 内 容 如 下 : 


#encoding =utf - 8 

from util.ObjectMap import * 

from util.KeyBoardUtil import KeyboardKeys 
from util.ClipboardUtil import Clipboard 
from util.WaitUtil import WaitUtil 

from selenium import webdriver 

from action.PageAction import * 

import time 


def TestSendMailWithAttachment(): 
print u" 启动 Chrome 浏览 器 " 
open browser(" chrome") 
maximize browser() 
print u" 访 问 126 WAERT..." 
visit url("http://mail. 126.com") 
sleep(5) 
* 肠 言 页 面 出 现 的 关键 内 容 
assert string in pagesource(u"126 网 易 免 费 邮 -- 你 的 专业 电子 邮局 ") 
print u" 访 问 126 邮箱 登录 页 成 功 ” 
waitFrameToBeAvailableAndSwitchToIt("id", "x -URS - iframe") 
print u" 输 入 登录 用 户 名 " 
input_string("xpath", "//input[ @name = 'email']", 
print u" 输 入 登录 密码 ” 
input string("xpath", "//input[@name = 'password']", "xxx") 
# qul moiet 
click("id", "dologin") 
sleep(5) 
assert title(u" f] S ip 48" ) 
print u" 登 录 成 功 " 
print u" 添 加 联系 人 " 
# 星 式 等 特 通 讯 录 链接 在 页 面 上 可 见 
waitVisibilityOfElementLocated(" xpath", "//div[text() = ' 通 讯 录 ']") 
# qul et de 
click("xpath", "//div[text() = "i iR 3 ]") 
8E REEBUR A FL 
Click("xpath", "//span[text() = ' 新 建 联系 人 ']") 
# 输入 联系 人 妊 各 
input string("xpath", 
"//a[ (title = ' 编 辑 详细 姓名 ']/preceding - sibling::div/input", 
"lily") 
# MAKRAMA 
input_string(" xpath", 
"// » [@id= 'iaddress MAIL wrap']//input", 
"lily@qq. com" ) 
eod; RA efie 
click("xpath", 
"//span[text() = ' 设 为 星 标 联系 人 ']/preceding - sibling::span/b") 
# 输 人 了 详 系 人 手机 号 
input string("xpath", "// * [(2id- 'iaddress TEL wrap']//dd//input", 


"xxx" ) 
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"185xxxxx" ) 
# MAKRA SHE 
input string("xpath", "//textarea", u" Bb A") 
# Mili" ME UE, TERRA 
click("xpath","//span[text() = ' 确 定 ']") 
time. sleep(1) 
# 肠 言 页 面 是 否 出 现 关键 内 众 
assert string in pagesource("lily@qq. com" ) 
print u" 添 加 联系 人 成 功 " 
# Mili P T tE tk, VEA H DUIE IT 
click("xpath", "//div[. = ' 首 页 ']") 
# WC RET bb Be ih BUE UI E 
waitVisibilityOfElementLocated(" xpath", "//span[text() = ' 写 信 ']") 
# Mli T fi BETE, BEA E RTE 
click("xpath", "//span[text() = '5 f&']") 
print u" 开始 写 信 "” 
print u" 输 入 收 件 人 地 址 " 
input string("xpath", 
"//div[contains((?id,' mail emailinput')]/input", 
"xxx" ) 
print u" 输 入 邮件 主题 " 
input_string(" xpath", 
" //div[ @aria - label = ' 邮 件 主题 输入 框 , 请 输入 邮件 主题 ']/input"， 
u" Sr pee") 
print u" 单 击 上 传 附件 按钮 
click("xpath", "// div[contains( (? title, '600 首 MP3')]") 
# 等 巷 2 秘 ,以 便 上 传 脏 作 的 窗 休 加载 完 成 
sleep(2) 
print u" 上 传 附件 " 
paste_string(u"d:\\a. txt" ) 
# 按 Enter fih, Efe MIE 
press enter key() 
waitVisibilityOfElementLocated("xpath", '//span[. - ".E f£ 5E E" ]') 
print u" 上 传 附件 成 功 " 
# OEAMETEIE X lf] £rane ffe [fcr 
waitFrameToBeAvailableAndSwitchToIt("xpath", "//iframe[(4 tabindex = 1]") 
print u" 写 入 邮件 正文 " 
input_string("xpath"，"/html/body"，u" 发 给 光荣 之 路 的 一 封 信 " ) 
# 退出 邮件 正文 的 frame HE fk, E A BO Eoi ie f 
switch to default content() 
print u' S f& SE BL" 
print u" 开 始 发 送 邮 件 .….." 
click("xpath", "//header//span[text() = ' 发 送 ']") 
time.sleep(3) 
assert string in pagesource(u" $ 3X X I)" ) 
print u" 邮件 发 送 成 功 " 


close browser() 


if name  -- ' main - 
TestSendMailWithAttachment() 
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替换 TestSendMailWithAttachment. py 文件 中 的 “xxx? 为 有 效 的 126 邮箱 登录 账号 及 
密码 后 执行 该 文件 ,可 以 看 到 程序 会 自动 启动 Chrome 浏览 器 ,然后 访问 126 邮箱 ,向 邮箱 
中 添加 一 个 联系 人 ,并 发 送 一 封 带 附件 的 邮件 。 

(12) 在 util 包 中 新 建 一 个 名 叫 ParseExcel. py 的 Python 文件 ,用 于 实现 读 取 Excel 数 
据 文件 代码 封装 ,具体 内 容 如 下 : 

# encoding = utf -8 

import openpyxl 

from openpyxl. styles import Border, Side, Font 

import time 





class ParseExcel(object) : 


def — init (self): 
self.workbook - None 
self.excelFile - None 
self.font = Font(color = None) £ AF [KP E 
# BÉ RGB ffi 
self.RGBDict = ('red': 'FFFF3030', 'green': 'FF008B00'] 


def loadWorkBook(self, excelPathAndName) : 
# 将 Excel 文件 加 裁 到 内 存 , 并 获 吏 其 workbook 对 条 
try: 
self.workbook - openpyxl.load workbook(excelPathAndName) 
except Exception, e: 
raise e 
self.excelFile - excelPathAndName 
return self. workbook 


def getSheetByName(self, sheetName): 
# 根据 sheet 名 获取 该 sheet 对 条 
try: 
Sheet = self.workbook.get sheet by name(sheetName) 
return sheet 
except Exception, e: 


raise e 


def getSheetByIndex(self, sheetIndex): 
# 根据 sheet 的 案 3| 号 获取 该 sheet 对 条 
try: 
sheetname = self.workbook.get sheet names()[sheetIndex] 
except Exception, e: 
raise e 
Sheet - self.workbook.get sheet by name(sheetname) 
return sheet 


def getRowsNunber(self, sheet): 
# HIR sheet 中 有 数据 区 域 的 结束 行 号 


return sheet.max row 
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def getColsNunber(self, sheet): 
* KIR sheet 中 有 数据 区 域 的 结束 列 号 


return sheet. max_column 


def getStartRowNumber( self, sheet): 
# 获取 sheet PH GE RM AT 


return sheet.min row 


def getStartColNumber(self, sheet): 
* 获取 sheet pA CB DX HM JE RAG 


return sheet.min column 


def getRow(self, sheet, rowNo): 
# 获取 sheet 中 有 划一 行 ,返回 的 是 这 一 行 万 有 的 数据 内 容 组 成 的 tuple, 
# FERM 工 开始 ,sheet. rows[1] 表 示 第 一 行 
try: 
return sheet.rows[rowNo - 1] 
except Exception, e: 
raise e 


def getColumn(self, sheet, colNo): 
* JE sheet rh AE— 9), 返回 的 是 这 一 列 万 有 的 数据 内 容 组 成 tuple, 
# FERM 工 开始 ,sheet. colums[1] s f — Hl 
try: 
return sheet.columns[colNo - 1] 
except Exception, e: 
raise e 


def getCellOfValue(self, sheet, coordinate - None, 
rowNo - None, colsNo - None): 
# RIAT NEP TED fir PES o] ERGO PKI, RA 176, 
# sheet.cell(row = 1, column = 1).value, 
# 表示 excel 中 第 一 行 第 一 列 的 值 
if coordinate ! = None: 
try: 
return sheet.cell(coordinate = coordinate).value 
except Exception, e: 
raise e 
elif coordinate is None and rowNo is not None and V 
colsNo is not None: 
try: 
return sheet.cell(row - rowNo, column - colsNo).value 
except Exception, e: 
raise e 
else: 
raise Exception(" Insufficient Coordinates of cell '!") 


def getCellOfObject(self, sheet, coordinate - None, 
rowNo - None, colsNo - None): 
EON T OC NEI RES , DT IURE OC ME PITE o PEBUCE SR SL, 
# 也 可 以 直接 根据 Excel rif jc e MRAR 
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# 如 getCellObject(sheet, coordinate = 'A1') or 
# getCellObject(sheet, rowNo = 1, colsNo = 2) 
if coordinate ! - None: 
try: 
return sheet.cell(coordinate - coordinate) 
except Exception, e: 
raise e 
elif coordinate -- None and rowNo is not None and V 
colsNo is not None: 
try: 
return sheet.cell(row - rowNo,column - colsNo) 
except Exception, e: 
raise e 
else: 
raise Exception(" Insufficient Coordinates of cell !") 


def writeCell(self, sheet, content, coordinate - None, 
rowNo - None, colsNo - None, style - None): 
FARE TOC MEE Excel D Ii 93 A8 RKF e] AB b I8] HOC PG A Rt, 
# FERM 1 Fi 参数 style Aus TÍKÜJBI AT A E, 比如 red, green 
if coordinate is not None: 
try: 
sheet.cell(coordinate = coordinate).value = content 
if style is not None: 
sheet.cell(coordinate = coordinate). V 
font - Font(color - self.RGBDict[style]) 
self.workbook.save(self.excelFile) 
except Exception, e: 
raise e 
elif coordinate -- None and rowNo is not None and V 
colsNo is not None: 
try: 
sheet.cell(row = rowNo,column = colsNo).value = content 
if style: 
sheet.cell(row = rowNo,column = colsNo).\ 
font - Font(color - self.RGBDict[style]) 
self. workbook. save(self.excelFile) 
except Exception, e: 
raise e 
else: 
raise Exception(" Insufficient Coordinates of cell !") 


def writeCellCurrentTime(self, sheet, coordinate = None, 
rowNo = None, colsNo = None): 
# 写 人 当前 的 有 时间, 下 奈 从 工 开始 
now = int(time.time()) ## 显 示 为 时 间 改 
timeArray = time.localtime(now) 
currentTine = time.strftime(" $Y- &m- %d $H: £M: $S", tineArray) 
if coordinate is not None: 
try: 
Sheet.cell(coordinate = coordinate).value = currentTime 
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self.workbook.save(self.excelFile) 
except Exception, e: 


raise e 
elif coordinate -- None and rowNo is not None V 
and colsNo is not None: 


try: 

Sheet.cell(row = rowNo, column = colsNo 
).value = currentTime 

self.workbook.save(self.excelFile) 

except Exception, e: 
raise e 

else: 
raise Exception(" Insufficient Coordinates of cell '!") 


if name  -- ' main ': 
# 测试 代码 
pe = ParseExcel() 
# 测 试 所 需 Excel 文件 "126 邮箱 创建 联系 人 并 发 邮 作 .xlsx", 请 自行 创建 
pe. loadWorkBook( u'D:\\PythonProject\\126 邮箱 创建 联系 人 并 发 邮件 .xlsx') 
print "通过 名 称 获取 sheet 对 象 的 名 字 :",\ 
pe. getSheetByName(u" 联 系 人 ").title 
print "通过 index 序号 获取 sheet 对 象 的 名 字 :",\ 
pe. getSheetByIndex(0).title 
sheet = pe.getSheetByIndex(0) 
print type( sheet) 
print pe.getRowsNumber(sheet) £z JJ X fr 
print pe.getColsNumber(sheet)  £ jk X5 
rows = pe.getRow(sheet, 1) # 和 获取 第 一 行 
for i in rows: 
print i.value 
# KRPP RIAT E 
print pe.getCellOfValue(sheet, rowNo = 1, colsNo = 1) 
pe. writeCell( sheet，u' 我 爱 祖 国 '，rowNo = 10, colsNo = 10) 
pe.writeCellCurrentTime(sheet, rowNo = 10, colsNo = 11) 


(13) 在 testData 目录 中 新 建 一 个 名 叫 *126 邮箱 创建 联系 人 并 发 邮件 . xlsx” 的 Excel 
文件 ,在 该 Excel 文件 中 创建 5 张 工作 表 , 分 别 命 名 为 “测试 用 例 ”“ 登 录 ”“ 联 系 人 ”发 邮件 ” 
及 “创建 联系 人 ”。 

“测试 用 例 ” 工 作 表 用 于 存放 测试 用 例 ,具体 内 容 如 表 15-6 所 示 。 














表 15-6 
数据 驱动 的 
调用 框架 | 用 例 步 了 是 否 | 执行 结束 | 执行 
Ia eps MNAE | za | sag | ELS |n| MA aR 
sheet 名 
使 用 有 效 的 账号 | ，， 
usa — rag | 关键 字 | sx y 
添加 联系 人 批量 添加 联系 人 | ”数据 | 创建 联系 人 | 联系 人 |y 
登录 126 邮箱 
发 送 带 附 件 的 邮件 | 后 ,发 送 一 封 带 | 关键 字 | 发 邮件 y 
附件 的 邮件 
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表 15-6 中 “调用 框架 类 型 " 列 ,表示 执行 本 条 测试 用 例 用 到 的 框架 类 型 ,如 果 使 用 关键 
字 驱 动 框架 执行 ,必须 填写 "关键 字 ” 三 个 关键 字 串 ,如 果 使 用 的 是 数据 驱动 框架 执行 ,必须 
填写 “数据 ”两 个 关键 字 串 ,测试 框架 将 根据 这 两 个 关键 字 来 识别 具体 使 用 的 何 种 框架 执行 。 
数据 驱动 框架 所 需要 的 数据 表 对 应 “数据 驱动 的 数据 源 sheet 名 ” 列 所 给 的 工作 表 名 。 

“登录 ”工作 表 用 于 存放 登录 126 邮箱 的 步骤 中 所 用 到 的 关键 字 及 需要 的 输入 数据 等 ， 
具体 内 容 如 表 15-7 所 示 。 









































表 15-7 
- su 
操作 E 测试 
测试 步骤 描述 | X 键 字 | 元 素 的 | Boaasz ja 作 值 | 执行 | Linn 
定位 方式 时 间 = 

果 | 息 | 图 
打开 浏览 器 open_browser firefox 
访问 被 测试 网 hitoi// 
hk http://www. | visit url 126 MNM: 
126. com PONN 
最 大 化 窗口 maximize_browser 
等 待 126 邮箱 
登录 主页 加 载 | sleep 5 
断言 当前 活动 
页 面 源码 中 是 "E oer 
5126 网 assert string in 费 邮 - -你 的 
易 免 费 邮 -你 的 _pagesource 专业 电子 
专业 电子 邮局 ” id 
显 式 等 待 id 属 
iion bind waitFrameToBe 

AvailableAnd id x-URS-iframe 
eig E a SwitchTolt 
进 % 
frame 框 中 
输入 登录 用 户 名 | input_string spi || heit noe 汪 放 
= 'email' ] 
输入 登录 密码 | input string xpa | /"imput(Gmame |. 
= 'password' ] 

x - “登录 ”| dick id dologin 
等 待 sleep 5 
切 回 默认 会 话 | switch_to_default 
窗 体 content 
断言 登录 成 功 
后 的 页 面 标题 
是 否 包含 * 网 易 | assert title ad 邮 箱 
邮箱 6.0 版 " 关 T 
键 内 容 
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R 15-7 中 的 “关键 字 ” 列 表示 的 字符 串 将 与 action 包 中 PageAction. py 文件 中 的 函数 
名 一 一 映射 ,后 面临 近 的 3 列 均 是 这 些 函 数 需 要 的 参数 值 , 其 中 “操作 值 ” 列 表示 操作 页 面 元 
素 需 要 的 输入 数据 ,或 者 断言 关键 数据 等 。 从 “测试 执行 时 间 列 ”及 以 后 的 列 都 是 在 测试 过 
程 中 写 入 测试 结果 信息 的 列 ,后续 表 中 这 些 列 的 作用 均一 致 , 将 不 再 做 解释 。 

“联系 人 ”工作 表 用 于 存放 添加 联系 人 模块 所 需要 的 联系 人 数据 ,具体 内 容 如 表 15-8 
所 示 。 




















表 15-8 
执行 
是 否 设 为 2 执行 
姓名 电子 邮箱 手 机 号 星 标 联系 人 t 2 是 否 执行 | 结束 结果 
时 间 
sr | sr@qq. com 15xxxxxxxxx 否 别名 y 
wex | wex(2qq. com 1555xxxxxxx 是 星 标 联系 人 y 
lucy | lucy@126. com 187xxxxxxxx E 添加 新 的 联系 人 y 
lily | lily(à qq. com 13778xxxxxx 是 同事 y 
amy | amy(Zqq. com 158xxxxxxxx 否 一 面 之 缘 的 人 n 
anne | anne@126. com 1398xxxxxxx 是 邮件 往来 之 人 y 























“发 邮件 ?工作 表 用 于 存放 发 送 邮 件 模块 的 实现 步骤 ,其 表 结 构 同 “登录 "工作 表 , 有 具体 内 
容 如 表 15-9 所 示 。 





表 15-9 
操作 ma DAE 
元 素 的 操作 元 素 的 - | 试 | 误 | 误 
测试 步骤 描述 关 键 字 定位 定位 表达 式 操作 值 pu P PALA 
方式 果 | 息 | 图 
21: click xpath |//div[. = ' 首 页 中 





判断 “ 写 信 ”按钮 是 | waitVisibilityOf 


Ev 
否 在 页 面 上 可 见 | ElementLocated | 77 |//span[text(? 一 ' 写 信 ] 





单 击 “ 写 信 ” 按 钮 | click xpath |//span[textO — "S fä] 





di ins (@ id. ' Yum 
输入 收 件 人 地 址 | input string xpath | //divLeontains (@id, '_ |xxx@aq 


mail emailinput') ]/input | com 


/ / div [ @ aria-label = ' lif 











输入 邮件 主题 input_string xpath | 件 主题 输入 框 ,请 输入 邮 Fi 
件 主题 ']/input 
单 击 * 上 传 附件 ”| |: // div[contains( @ title, 
click xpath E 
链接 '600 首 MP3')] 
Li (EPEA paste_string d; Wa. txt 





模拟 键盘 回 车 键 | press enter key 





























- 388 - 




















第 15 章 自动 化 测试 框架 的 搭建 及 测试 实战 





























续 表 
Eu 操作 元 素 的 NX x ` e 
JU Ju E 
测试 步骤 描述 关 键 字 定位 定位 表达 式 操作 值 RE alela 
方式 果 | 息 | 图 
显 式 等 待 附件 上 | waitVisibilityOf //span[text() =" E f£ 
传 完 成 ElementLocated peh 完成 "] 
如 果 邮 件 正文 的 | waitFrameToBe 
frame 框 可 见 , 切 | AvailableAnd xpath |//iframe[ (2tabindex—1 |] 
换 进 该 frame 中 SwitchTolt 
输入 邮件 正文 input_string xpath | /html/body 之 路 的 一 
封 信 
退出 邮件 正文 的 | switch_to_default 
frame _content 
单 击 邮 件 发 送 click path / /header/ /span[ text) = 
等 待 邮 件 发 送 成 seen A 
功 ,返回 结果 
断言 页 面 源码 中 
是 否 出 现 “发 送 成 assert string _ in ARRI 
功 "关键 内 容 _pagesource 
关闭 浏览 器 close_browser 


























“创建 联系 人 "工作 表 用 于 存放 创建 联系 人 模块 的 实现 步骤 ,具体 内 容 如 表 15-10 所 示 。 




















表 15-10 
操作 操 
测试 步骤 描述 关 € F 元 素 的 | 操作 元 素 的 定位 表达 式 | 作 
定位 方式 值 
击 “ 通 讯 录 ” 链 接 , 进 
WE SURGE ik xpath | //div[textO 二 "通讯 录 "] 
MORK I 
显 式 等 待 “新建 联 系 | waitVisibilityOfEiementLocated | xpath | SPTO BERE 
人 "按钮 在 页 面 上 可 见 系 人 "] 
单 击 “ 新 建 联系 人 ” / /span[ text ) =" 3f 2 lk 
click xpath 
按钮 系 人 "] 
显 式 等 待 输入 联系 人 //a[@ title= ' 4i 48 1 4 
姓名 框 是 否 在 页 面 上 | waitVisibilitrOfElementLocated xpath | 姓 名 ' ]/preceding- 
可 见 sibling: : div/input 
/ /a| & title= ' 4g $E T 4 
输入 联系 人 姓名 input_string xpath | 姓名 ']/preceding-sibling:: | A 
div/input 
输入 电子 邮箱 input. string soak | /OM nts | 
MAIL wrap' ]/ /input 
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续 表 
操作 操 
测试 步骤 描述 x 键 7 TRH | 操作 元 素 的 定位 表达 式 | dE 
定位 方式 值 





//span[text() 王 ' 设 为 星 
设 为 星 标 联系 人 click xpath | 标 联 系 人 ' ]/preceding- | D 
sibling: :span/b 

//* [@id= ' iaddress _ 





























输入 手机 号 input_string xpath TEL wrap" ]/ /dd/ input C 
输入 联系 人 备注 信息 input string xpath / /textarea E 
Modan 按钮 保存 click xpath //span[. = 二 "确定 'j 

等 待 2 秒 sleep 2 
断言 联系 人 是 否 成 功 TN 

添加 assert_string_in_pagesource B 


K 15-10 中 的 “操作 值 ” 列 的 数据 对 应 “联系 人 ”工作 表 中 对 应 的 数据 列 编号 ,表示 该 测 
试 步 又 需要 的 数据 从 “联系 人 ”工作 表 中 相应 的 列 中 取 。 
(14) 修改 config 包 中 的 VarConfig. py 文件 内 容 如 下 : 


# encoding = utf - 8 
import os 


ieDriverFilePath = "c: MIEDriverServer" 
chromeDriverFilePath = "c:Vchromedriver" 
firefoxDriverFilePath = "c:Vgeckodriver" 


# HI MIEN E A RMR A RMH BE GG 

parentDirPath = os.path.dirname(os.path.dirname(os.path.abspath( file _))) 
# HARIATA R 

ScreenPicturesDir = parentDirPath + "\\exceptionpictures\\" 


# BE x FTE H ETE 
dataFilePath = parentDirPath + u"\\testData\\126 邮箱 创建 联系 人 并 发 邮件 .xlsx" 


# 测试 数据 文件 中 ,测试 用 例 表 中 部 分 列 对 应 的 数字 序号 
testCase testCaseName = 1 

testCase frameWorkName = 3 

testCase testStepSheetName - 4 

testCase dataSourceSheetName - 5 

testCase isExecute - 6 

testCase runTime - 7 

testCase testResult - 8 


# 用 例 步 坚 表 中 ,部 分 列 对 应 的 数字 序号 
testStep testStepDescribe = 1 
testStep keyWords = 2 

testStep locationType - 3 
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testStep locatorExpression - 4 
testStep operateValue - 5 
testStep runTime - 6 

testStep testResult - 7 
testStep errorInfo - 8 
testStep errorPic - 9 


# 数据 源 表 中 ,是 否 执行 列 对 应 的 数字 编号 
dataSource isExecute = 6 

dataSource email = 2 

dataSource runTime = 7 

dataSource result - 8 


(15) 修改 testScripts 包 中 的 _ init _. py 文件 内 容 如 下 : 


# encoding - utf - 8 


from action. PageAction import * 

from util.ParseExcel import ParseExcel 
from config. VarConfig import * 

import time 

import traceback 


# 设置 此 次 测试 的 环境 编 码 为 utf -8 
import sys 

reload(sys) 

sys. setdefaultencoding(" utf - 8") 


* 创建 解析 Excel 对 象 
excelObj = ParseExcel() 


# 将 Excel Bei x fI SUI E 
excelObj. loadWorkBook(dataFilePath) 





(16) 在 testScripts 包 中 新 建 一 个 名 叫 WriteTestResult. py 的 Python 文件 ,用 于 实现 
向 Excel 中 写 人 测试 结果 信息 的 公共 方法 ,具体 内 容 如 下 : 


# encoding = utf - 8 
from. import * 


# MARAE RRITAR N, 向 Excel hj HR ÉTAATR fri e 
def writeTestResult(sheetObj, rowNo, colsNo, testResult, 
errorinfo = None, picPath = None): 
# 测试 通过 结 扶 信息 为 绿色 ,失败 为 红色 


colorDict = {"pass" :"green", "faild":"red", "":None} 
POOR "ECT IBI" TEKA" H AER sheet 表 " 中 部 有 测试 执行 时 间 和 
# 测试 结 扣 列 ,定义 此 字典 对 象 是 为 区 分 具体 应 该 写 哪 个 工作 表 
colsDict = { 

"testCase":[testCase runTime, testCase testResult], 


"caseStep":[testStep runTime, testStep testResult], 
"dataSheet" :|[dataSource runTime, dataSource result]] 
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try: 
# MHR sheet H, GA WRAK 
excelO0bj.writeCell(sheetObj, content = testResult, 
rowNo = rowNo, colsNo = colsDict[colsNo][1], 
style = colorDict[testResult]) 
if testResult -- "": 
# MESH YOCME A GE 
excelObj.writeCell(sheetObj, content = "", 
rowNo - rowNo, colsNo - colsDict[colsNo][0]) 
else: 
# WER sheet 中 , 写 人 测试 时 间 
excel0bj. writeCellCurrentTime( sheetObj, 
rowNo = rowNo, colsNo = colsDict[colsNo][0]) 
if errorInfo and picPath: 
# WEIR sheet 1h, GA FEE EB 
excelO0bj.writeCell(sheetObj, content = errorInfo, 
rowNo - rowNo, colsNo - testStep errorInfo) 
* dE XE JE sheet H, 写 人 异常 截图 路 径 
excel0bj.writeCell(sheetObj, content = picPath, 
rowNo - rowNo, colsNo - testStep errorPic) 
else: 
if colsNo == "caseStep" : 
# dE IPAE sheet rfi, il S E fi BAE NE 
excel0bj. writeCell(sheetObj, content = "", 
rowNo - rowNo, colsNo - testStep errorInfo) 
# 在 测试 步 坚 sheet 中 , S EE f BAE NE 
excelObj.writeCell(sheetObj, content = "", 
rowNo - rowNo, colsNo - testStep errorPic) 
except Exception, e: 
print u" Sj excel 时 发 生 异 常 " 
print traceback.print exc() 


(17). 在 testScripts 包 中 新 建 一 个 名 叫 CreateContacts. py 的 Python 文件 ,用 于 实现 向 
126 邮箱 添加 联系 人 的 数据 驱动 框架 部 分 ,具体 内 容 如 下 : 


#encoding= utf - 8 
from. import * 
from WriteTestResult import writeTestResult 


def dataDriverFun(dataSourceSheetObj, stepSheetObj): 
try: 
BOXOIGHEI ET B IA NS S 
datalsExecuteColumn = excelObj.getColumn( 
dataSourceSheetObj, 
dataSource isExecute) 
# 获取 数据 源 表 中 "电子 月 逢 " 列 对 条 
emailColumn = excel0bj.getColumn( 
dataSourceSheetObj, dataSource email) 
E RWA TEE D fe TE E K RAGT EE 
stepRowNums = excelObj.getRowsNumber(stepSheetObj) 
# 记录 成 功 执 行 的 数据 条 数 


successDatas = 0 
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Eo mI m 
requiredDatas - 0 
for idx, data in enumerate(dataIsExecuteColumn[1:]): 
# 遍历 数据 源 表 , 准备 进行 数据 驱动 测试 
# 因为 第 一 行 是 奈 题 行 , 万 以 从 第 二 行 开始 六 历 
if data. value == "y": 
print u 开始 添加 联系 人 " %s"" %emailColumn[idx + 1]. value 
requiredDatas += 1 
# GEI HAGIIHERERCE i 
successStep - 0 
for index in xrange(2, stepRowNums * 1): 
# 获取 数据 驱动 测试 步 缀 表 中 
# 第 index 行 对 象 
row0bj = excelObj.getRow(stepSheetObj, index) 
E 获取 关键 字 作 为 调用 的 函数 名 
keyWord = rowObj[testStep keyWords - 1].value 
# JOIGEEOUE E fo Ir ANEA WIH R1 S3 
locationType = rowObj[testStep locationType - 1]. value 
# DIRIR METER IE fo REIN ME 2 BIA ERE B 
locatorExpression = rowObj[ 
testStep locatorExpression - 1].value 
# EOIBEEI TES WI EUM 3C 
operateValue = rowObj[testStep operateValue - 1].value 
if isinstance(operateValue, long): 
operateValue - str(operateValue) 
if operateValue and operateValue. isalpha(): 
# 如 黑 operateValue ZARAZ, HA H MEME 
# 从 数据 源 表 中 根据 坐标 获取 对 应 单元 稿 的 数据 
coordinate = operateValue + str(idx + 2) 
operateValue = excelObj.getCellOfValue( 
dataSourceSheetObj, 
coordinate - coordinate) 
EO HEEIATI python 表达 式 , 此 表达 式 对 应 的 
# 是 PageAction. py 文件 四 的 页 面 动 作 郁 数 调 用 的 字符 第 表示 
tmpStr = "'$s', '%s'" &(locationType.lower(), 
locatorExpression. replace("'", '"') 
) if locationType and locatorExpression else "" 


if tmpStr: 
tmpStr += \ 
", u'" + operateValue +"'" if operateValue else "" 
else: 
tmpStr += V 


"u'" + operateValue +"'" if operateValue else "" 
runStr = keyWord + "(" + tmpStr + ")" 
# print runStr 
try: 
# 通过 eval PRAEC, TE BEBE MU Vt iki z fE R B A E B 
# 当成 有 效 的 Python Jeik DAT, Mili T ET iX 2E RHY sheet 
# 中 关键 字 在 ageaction. py XF PXHI ÁI H Z, 
EO CI SEI EFE 
if operateValue ! = uw" €": 
# 当 operateValue ffr y "A "Ht, 
# LES li I*3954:3 


eval(runStr) 
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except Exception, e: 
print u" 执 行 步骤 ' $% s' 发 生 异 常 ”\ 
&rowObj[testStep testStepDescribe - 1].value 
print traceback.print exc() 
else: 
successStep *- 1 
print u" 执行 步骤 ' S s' EI" N 
% rowObj[testStep testStepDescribe - 1].value 
if stepRowNums -- successStep * 1: 
successDatas += 1 
# OUR UIHATTIUIETERCR FERR DA HL IEEE 
# 说 明 第 idx + 2 行 的 数据 执行 通过 , 写 人 通过 信息 
writeTestResult(sheetObj = dataSourceSheetObj, 
rowNo - idx * 2, colsNo - "dataSheet", 
testResult - "pass") 
else: 
BOWAXISB 
writeTestResult(sheetObj = dataSourceSheetObj, 
rowNo - idx * 2, colsNo - "dataSheet", 
testResult - "faild") 
else: 
# 将 不 需要 执行 的 数据 行 的 执行 上 时间 和 执行 结 扣 单元 格 洲 空 
writeTestResult(sheetObj = dataSourceSheetObj, 
rowNo - idx * 2, colsNo - "dataSheet", 
testResult - "") 
if requiredDatas -- successDatas: 
# 只 要 当成 功 执行 的 数据 条 数 等 于 设 设 置 为 需要 执行 的 数 
E RY, A CS WELLE IE I ETATE FRE HA 73 3d 
return 1 
# 表示 调用 数据 驱动 的 测试 用 例 执 行 失败 
return 0 
except Exception, e: 
raise e 


(18) f£ testScripts 包 中 新 建 一 个 名 叫 TestSendMailAndCreateContacts. py 的 Python 
文件 ,用 于 实现 关键 字 与 数据 驱动 逻辑 部 分 ,登录 126 邮箱 ,然后 向 邮箱 中 添加 联系 人 并 发 
送 一 封 带 附 件 的 邮件 ,具体 内 容 如 下 : 


# encoding= utf - 8 
from. import > 

from. import CreateContacts 

from WriteTestResult import writeTestResult 


def TestSendMailAndCreateContacts(): 
try: 

# R Excel 文件 中 的 sheet 名 获取 sheet 对 条 
caseSheet = excelObj.getSheetByName(u" 测试 用例" ) 
# 获取 测试 用 例 sheet 中 是 否 热 行列 对 条 
isExecuteColumn = excelObj.getColumn(caseSheet, testCase isExecute) 
# 记录 执行 成 功 的 测试 用 例 个 数 
successfulCase = 0 
# 记录 需要 执行 的 用 例 个 数 
requiredCase = 0 
for idx, i in enumerate(isExecuteColumn[1:]): 
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# 因为 用 例 sheet 中 第 一 行为 标题 行 ,无 须 执行 
caseName = excelObj.getCellOfValue(caseSheet, 
rowNo - idx * 2, colsNo - testCase testCaseName) 
# OMBRE Ur "BEIC PL" RP BEC, DUET EE BEDS DUET BU HH I 
if i.value.lower() == 'y': 
requiredCase *- 1 
# 获取 测试 用 例 表 中 ,第 idx + 工行 中 
# MEIT EEA EH MERK 
useFrameWorkName = excelObj.getCellOfValue( 
caseSheet, rowNo - idx * 2, 
colsNo - testCase frameWorkName) 
# 获取 测试 用 例 表 中 ,第 idx + 1 fprhdA fH BIMI IPTE sheet 各 
stepSheetName = excel0bj. getCell0fValue( 
caseSheet, rowNo = idx + 2, 
colsNo = testCase testStepSheetName) 
print" ----", stepSheetName 
if useFrameWorkName == u" 数 据 ”: 
print u" xxxxxx 调用 数据 驱动 60e" 
# 获取 测试 用 例 表 中 ,第 idx +1 fT, WIT En 
# 数据 驱动 的 用 例 所 使 用 的 数据 sheet 名 
dataSheetName = excelObj.getCellOfValue( 
caseSheet, rowNo - idx * 2, 
colsNo - testCase dataSourceSheetName) 
# 获取 第 idx 1 fTIB BU IBI R sheet 对 条 
stepSheetObj = excelObj.getSheetByName( stepSheetName) 
# 获取 第 idx 1 行 测试 用 例 使 用 的 数据 sheet 对 条 
dataSheetObj = excelObj.getSheetByName(dataSheetName) 
Es EC IS e A A FT VS TIERRA 
result = CreateContacts. dataDriverFun(dataSheetObj, stepSheetObj) 
if result: 
print u" 用 例 * s 执行 成 功 ”% caseName 
SuccessfulCase += 1 
writeTestResult(caseSheet, rowNo = idx + 2, 
colsNo - "testCase", testResult - "pass") 
else: 
print u" Hj * s 执行 失败 ”s$ caseNane 
writeTestResult(caseSheet, rowNo = idx + 2, 
colsNo - "testCase", testResult - "faild") 
elif useFrameWorkName == u" 关 键 字 " : 
print u" xxxxxx 调用 关键 字 驱 动 xxxxxxx" 
caseStep0bj = excel0bj. getSheetBYName( stepSheetName) 
stepNums = excelObj.getRowsNunber(caseStepObj) 
successfulSteps - 0 
print u" 测试 用 例 共 $% sip" * stepNums 
for index in xrange(2，stepNums + 1): 
# 因为 第 一 行 是 标题 行 ,无 须 执 行 
* GORGE HE sheet 中 第 index 行 对 条 
stepRow = excelO0bj.getRow(caseStepObj, index) 
# 获取 关键 字 作 为 调用 的 函数 各 
keyWord = stepRow[testStep keyWords — 1].value 
# BRRR A MA WIS p 3h St 
locationType = stepRow[testStep locationType - 1].value 
# BRIR METR E lir Se A C TER BI ER t 
locatorExpression = stepRow[ 
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testStep locatorExpression — 1].value 
# 获取 操作 值 作为 将 用 函数 的 参数 
operateValue = stepRow[testStep operateValue - 1].value 
if isinstance(operateValue, long): 

# UMR operateValue 从 为 数字 型 ， 

SONG PERCY REB, BB REIR HE 

operateValue - str(operateValue) 
# 构造 需要 执行 的 python 表达 式 , 此 表达 式 对 应 的 
# Jd Pageaction. py X fl fd Va lli SJ TE PRECII FE SB 
tmpStr = "'%s', '$s'" $ (locationType. lower(), 

locatorExpression.replace(" ", '"') 

) if locationType and locatorExpression else "" 


if tmpStr: 
tmpStr += V 
", u'" + operateValue +"'" if operateValue else "" 
else: 
tmpStr += V 


u'" + operateValue + "'" if operateValue else "" 
runStr = keyWord + "(" + tmpStr + ")" 
# print runStr 
try: 
# 通过 eval RAe, JE DEBE TT I ah E RR FERRER 
# 当成 有 效 的 Python 表达 式 执行 , M MAITEI II sheet 
# 中 关键 字 在 ageaction. py 文件 中 对 应 的 映射 方法 ， 
# KERI EIC ILE 
eval(runStr) 
except Exception, e: 
print v 执行 步骤 ' #% s' 发 生 异 常 ”\ 
* stepRow[testStep testStepDescribe — 1].value 
# 截 吏 异常 屏幕 图 片 
capturePic = capture screen() 
# IREN MISE a tg 
errorInfo = traceback.format exc() 
writeTestResult(caseStepObj, rowNo - index, 
colsNo = "caseStep', testResult = "faild", 
errorinfo = str(errorInfo), picPath = capturePic) 
else: 
successfulSteps += 1 
print u" 执 行 步骤 '% s' BEI" \ 
% stepRow[testStep testStepDescribe — 1].value 
writeTestResult(caseStepObj, rowNo = index, 
colsNo = "caseStep', testResult = "pass") 
if successfulSteps -- stepNums - 1: 
successfulCase *- 1 
print u" 用 例 '%s' 执 行 通过 " 5* caseName 
writeTestResult (caseSheet, rowNo = idx + 2, 
colsNo = "testCase", testResult = "pass") 
else: 
print u" 用 例 € s 执行 失败 ”% caseNane 
writeTestResult(caseSheet, rowNo - idx * 2, 
colsNo - "testCase", testResult - "faild") 
else: 
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# 清空 不 需要 执行 用 例 的 执行 时 间 和 执行 缚 时 。 

E HARE, AEKA 

writeTestResult(caseSheet, rowNo = idx + 2, 
colsNo = "testCase", testResult = "") 


print u" # sd & Fl Bl, sd 条 需要 被 执行 ,成 功 执行 %d 条 ”\ 
5 (len(isExecuteColumn) - 1, requiredCase, successfulCase) 
except Exception, e: 
print traceback.print exc() 


(19) 在 工程 Key WordAndDataDrivenFrameWork 根 目录 下 新 建 一 个 名 叫 RunTest. py 的 
Python 文件 ,用 于 编写 框架 入 口 代码 ,具体 内 容 如 下 : 


#encoding= utf -8 
from testScripts. TestSendMailAndCreateContacts import \ 
TestSendMailAndCreateContacts 


if name  -- " main ": 


TestSendMailAndCreateContacts() 


执行 RunTest. py 文件 ,可 以 看 到 程序 自动 打开 浏览 器 ,登录 126 邮箱 ,添加 联系 人 并 
发 送 一 封 带 附件 的 邮件 。 部 分 执行 结果 输出 信息 如 图 15-17 所 示 。 


C:\Python27\python. exe D:/PythonProject /KeyNordAndDataDrivenF rameWork/RunTest. py 


执行 步骤 “打开 浏览 器 ”成 功 

执行 步骤 “访问 被 测试 网 址 http://mme. 126. com” 成 功 

执行 步骤“ 最 大 化 窗口 ”成 功 

执行 步骤 “等 待 126 邮 箱 登录 主页 加 载 完成 ， 成 功 

执行 步骤 “断言 当前 活动 页 面 源码 中 是 否 包含 “126 网 易 免费 邮 一 你 的 专业 电子 邮局 ”” 成 功 
执行 步骤 “ 显 式 等 待 id 属性 值 为 z-URS-i frame 的 生 ame 框 的 出 现 ， 然 后 切换 进入 该 frame 框 中 ”成 功 
执行 步骤 “输入 登录 用 户 名 ”成 功 

执行 步骤 “输入 登录 密码 ”成 功 

执行 步骤 “ 单 击 登录 按钮 ”成 功 

执行 步骤 “等 待 ”成 功 

执行 步骤 “ 切 回 默 认 会 话 窗 休 ”成 功 

执行 步骤 “断言 登录 成 功 后 的 页 面 标题 是 否 包 含 “网 易 邮箱 6. 0 版 ”关键 内 容 ” 成 功 
用 例 “登录 126 邮 箱 ” 执 行 通过 

一 一 创建 联系 人 

44444* 调用 数据 驱动 nnnm 

开始 添加 联系 人 “sreaqq. con" 

执行 步骤 “ 单 击 “ 通 讯 录 ”链接 ， 进 入 通讯 录 页 面 ”成 功 

执行 步骤 “显示 等 待 “ 新 建 联系 人 ”按钮 在 页 面 上 可 见 ”成 功 

执行 步骤 “ 单 击 “ 新 建 联系 人 ”按钮 ”成 功 

执行 步骤 “显示 等 待 输入 联系 人 姓名 框 是 否 在 页 面 上 可 见 ” 成 功 

执行 步骤 “输入 联系 人 姓名 ”成 功 

执行 步骤 “输入 电子 邮箱 ”成 功 

执行 步骤 “ 设 为 星 标 联系 人 ”成 功 

执行 步骤 “输入 手机 号 ”成 功 

执行 步骤 “输入 联系 人 备注 信息 ”成 功 

执行 步骤 “ 单 击 “ 确 认 ” 按 钮 ， 保 存 新 联系 人 ”成 功 

LAER Et 成 zh 





图 15-17 
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上 面 我 们 只 是 把 测试 过 程 及 结果 总 结 信息 输出 到 控制 台 ,但 不 方便 错误 排查 以 及 后 期 
结果 信息 查看 ,为 此 我 们 加 入 打印 日 志 功能 。 

(20) 通过 logging 模块 ,为 关键 字 && 数据 混合 驱动 框架 加 入 打印 日 志 功 能 。 在 
config 包 中 新 建 一 个 名 叫 Logger. conf 的 文件 ,用 于 配置 日 志 基本 信息 ,具体 内 容 如 下 : 


# logger.conf 

HPHRHRRHRHERRRRRRRRRHEHEHHHHHHHHEHEHEHEEREREHEH 
loggers] 

keys = root, example01, example02 

logger_root] 

level = DEBUG 

handlers = hand01, hand02 


logger_example01] 
handlers = hand01, hand02 
qualname = example01 
propagate = 0 





logger_example02] 
handlers = hand01, hand03 
qualname = example02 
propagate = 0 


PPHRHRRRR PEPER RPPP PRHEHPHRHHHRHHE HEHE ER pREHHHH 
[handlers] 
keys = hand01 , hand02, hand03 


[handler_hand01] 
class = StreanHandler 
level = INFO 
formatter = form01 
args = (sys. stderr, ) 


[handler_hand02] 

class = FileHandler 

level = DEBUG 

formatter = form01 

args = ( 'log\\Mail126TestLogfile. log', 'a') 


[handler hand03] 

class - handlers. RotatingFileHandler 

level = INFO 

formatter - form01 

args = ('logWMMaill26TestLogfile. log', 'a', 10 + 1024 * 1024, 5) 


BRBÉBBBBBBBBBRBRBRPPSRRRBERBBRBBBBEBBBBBBBBBBABBÉBR 
[formatters] 
keys = form01, form02 


[formatter form01] 
format = &(asctime)s % (filename)s[line: $ (lineno)d] % (levelname)s % (message)s 
datefmt = $Y- $m- $d $H: $M: $S 
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[formatter form02] 
format = % (name)- 12s: % (levelname) -8s $ (message)s 
datefnt- $Y- $m- $d SH: $M: $S 


(21) 在 util 包 中 新 建 一 个 名 叫 Log. py 的 Python 文件 ,用 于 初始 化 日 志 对 象 ,具体 内 
容 如 下 : 





# encoding = utf - 8 

import logging 

import logging.config 

from config. VarConfig import parentDirPath 


# 恋 取 日 志 配 置 文 件 
logging. config.fileConfig(parentDirPath + u"\config\Logger. conf" ) 


# ETE S BC 
logger = logging.getLogger(" example02" )# 或 者 example01 


def debug( message) : 
# JEX debug 级 别 日 志 打 印 方法 
logger. debug( message) 


def info(message) : 
# 定义 info 级别 日 志 打 印 方法 


logger. info(message) 


def warning(message): 
# 定义 warning ZI H TT El Zr i 


logger. warning(message) 


(22) 在 DataDrivenFrameWork 工程 根 目 录 下 创建 一 个 名 叫 log 的 目录 ,然后 修改 
testScripts 包 中 的 CreateContacts. py 和 TestSendMailAndCreateContacts. py 文件 的 内 容 
如 下 : 

CreateContacts. py 修改 后 的 内 容 如 下 : 


# encoding = utf - 8 

from. import * 

from WriteTestResult import writeTestResult 
from util.Log import * 


def dataDriverFun(dataSourceSheetObj, stepSheetObj): 
try: 
# KRAER DIE EPIS SR 
datalsExecuteColumn - excelObj.getColumn( 
dataSourceSheetObj, 
dataSource isExecute) 
# 获取 数据 源 表 中 "电子 邮箱 " 列 对 象 
emailColumn = excelObj.getColumn( 
dataSourceSheetObj, dataSource email) 
£OOIGIBUE BER ETE IX BU f13€ 
stepRowNums = excelObj.getRowsNumber(stepSheetObj) 
# 记录 成 功 执 行 的 数据 条 数 
successDatas = 0 


# 记录 谱 设 置 为 执行 的 数据 条 数 
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requiredDatas = 0 
for idx, data in enumerate(dataIsExecuteColum[1:]): 
# 遍历 数据 源 表 , 准备 进行 数据 驱动 测试 
# 因为 第 一 行 是 奈 题 行 ,万 以 从 第 二 行 开始 广 历 
if data.value == "y": 
logging. info(u" 开始 添加 联系 人 " & s"" 
% emailColumn[idx + 1].value) 
requiredDatas *- 1 
# EX IE RWITR DARIE ME 
successStep = 0 
for index in xrange(2, stepRowNums + 1): 
# KRAER MARAR P 
# 第 index 行 对 象 
rowObj = excelObj.getRow(stepSheetObj, index) 
E 获取 关键 字 作 为 调用 的 函数 名 
keyWord = rowObj[testStep keyWords - 1].value 
# KRR METKE fo Ir CIE WII i3 S3 
locationType = rowObj[testStep locationType - 1]. value 
# HIIRET ME lo KEE ME S BIA PRSE 3 
locatorExpression = rowObj[ 
testStep locatorExpression - 1].value 
# ONE TES WI PR EUM 3C 
operateValue = rowObj[testStep operateValue - 1].value 
if isinstance(operateValue, long): 
operateValue - str(operateValue) 
if operateValue and operateValue. isalpha(): 
# UMR operateValue WARAS, HA PRETI 
# 从 数据 源 表 巾 根据 坐 奈 获 到 对 应 单元 梢 的 数据 
coordinate = operateValue + str(idx + 2) 
operateValue = excelObj.getCellOfValue( 
dataSourceSheetObj, 
coordinate - coordinate) 
EO EE ATI python 表达 式 , 此 表达 式 对 应 的 
# 是 Pageaction. py 文件 四 的 页 面 动 作 郁 数 调 爵 的 字符 第 表示 
tmpStr = "'%s', '$s'" &(locationType.lower(), 
locatorExpression. replace("'", '"') 
) if locationType and locatorExpression else "" 





if tmpStr: 
tmpStr += V 
", u'" + operateValue +"'" if operateValue else "" 
else: 
tmpStr += V 


"u'" + operateValue +"'" if operateValue else "" 
runStr = keyWord + "(" + tmpStr + ")" 
£ print runStr 
try: 
# 通过 eval JE JE DEBE ATI Va ESTE PRESE HB e 
# 当成 有 效 的 Python KIT, M ili TA ET IRE TR sheet 
# 中 关键 字 在 ageAction. py 文件 中 对 应 的 映射 方 法 ， 
EO CB TUE BI EFE 
if operateValue ! = d g": 
# 当 operateValue ffr Jy "A "Ht, 
# EREA idi UK RA Mr ife 


eval(runStr) 
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except Exception, e: 
logging. info(u" 执 行 步 骤 '$% s' 发 生 异 常 \a” 
*&rowObj[testStep testStepDescribe - 1].value, 
traceback.format exc()) 
else: 
successStep += 1 
logging. info(u" ffr 25 E 5 s' 成 功 ” 
5 rowObj[testStep testStepDescribe - 1].value) 
if stepRowNums -- successStep * 1: 
successDatas += 1 
# OUI AKIHATTIUIEREECR FERR D A HL IEEE 
# 说 朋 第 idx+2 行 的 数据 执行 通过 , 写 人 通过 信息 
writeTestResult(sheetObj = dataSourceSheetObj, 
rowNo = idx + 2, colsNo = "dataSheet", 
testResult - "pass") 


else: 
# GARM B 
writeTestResult(sheetObj = dataSourceSheetObj, 
rowNo - idx * 2, colsNo - "dataSheet", 
testResult - "faild") 
else: 


# OMRIEEHN TIE GS DTI BI RUN (T5 IR OC S 
writeTestResult(sheetObj = dataSourceSheetObj, 
rowNo - idx * 2, colsNo - "dataSheet", 
testResult - "") 
if requiredDatas -- successDatas: 
# 生 有 当成 功 执 行 的 数据 条 数 等 于 设 设 置 为 需要 执行 的 数 
# 据 条 数 , 才 表示 泣 用 数据 驱动 的 测试 用 例 执 行 通过 
return 1 
# 表示 调用 数据 驱动 的 测试 用 例 执 行 失败 
return 0 
except Exception, e: 
raise e 


TestSendMailAndCreateContacts. py 文件 修改 内 容 如 下 : 


#encoding= utf -8 

from. import * 

from. import CreateContacts 

from WriteTestResult import writeTestResult 
from util.Log import * 


def TestSendMailAndCreateContacts(): 
try: 
# R Excel 文件 中 的 sheet 名 获取 sheet 对 条 
caseSheet = excelObj.getSheetByNane(u" 31] i, A H" ) 
# 获取 测试 用 例 sheet (PE A FT PIER 
isExecuteColumn = excelObj.getColumn(caseSheet, testCase isExecute) 
Eod fir D C PIT 
successfulCase - 0 
# 记录 需要 执行 的 用 例 个 数 
requiredCase = 0 
for idx, i in enumerate(isExecuteColumn[1:]): 
# AAHH sheet 中 第 一 行为 奈 题 行 ,无 须 热 行 
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caseName = excelObj.getCellOfValue(caseSheet, 
rowNo - idx * 2, colsNo - testCase testCaseName) 
H BREL ET EIC IL" er BO E A I, 执行 谈 设 置 为 执行 的 用 例 
if i.value.lower() == 'y': 
requiredCase += 1 
# 获取 测试 用 例 表 中 ,第 idx + 工行 由 
# MEITE (EHA ERK 
useFrameWorkName = excelObj.getCellOfValue( 
caseSheet, rowNo - idx * 2, 
colsNo - testCase frameWorkName) 
# 获 到 测试 用 陪 表 中 ,第 iax + 1 行 中 执行 用 例 的 步 凤 sheet 名 
stepSheetName = excelObj.getCellOfValue( 
caseSheet, rowNo - idx * 2, 
colsNo - testCase testStepSheetName) 
logging. info(u" -- 执行 测试 用 例 '$% s'--" %caseName) 
if useFrameWorkName == uw" 数据 ": 
logging.info(u" *xxxxx 调用 数据 驱动 xxxxxx") 
# 获取 测试 用 例 表 中 ,第 idx * 1 fT, DET E A88 
# 数据 驱动 的 用 例 所 使 用 的 数据 sheet 和 名 
dataSheetName = excelObj.getCellOfValue( 
caseSheet, rowNo - idx * 2, 
colsNo - testCase dataSourceSheetName) 
# 获取 第 idx 1 (TIB BUT BITE sheet 对 条 
stepSheetObj = excelObj.getSheetByName( stepSheetName) 
# 获取 第 idx 1 行 测试 用 例 使 用 的 数据 sheet 对 条 
dataSheetObj = excelObj. getSheetByName(dataSheetName) 
# 通过 数据 纹 动 框架 执行 添加 联系 人 
result = CreateContacts. dataDriverFun(dataSheetObj, 
stepSheetObj) 
if result: 
logging. info(u" 用例 "% s" 执 行 成 功 ”% caseName) 
successfulCase += 1 
writeTestResult(caseSheet, rowNo - idx * 2, 
colsNo - "testCase", testResult - "pass") 
else: 
logging. info(u" JB BI" & s" 执 行 失败 ”% caseNane) 
writeTestResult(caseSheet, rowNo = idx + 2, 
colsNo - "testCase", testResult - "faild") 
elif useFrameWorkName == u" 关 键 字 " : 
logging.info(u" xx*xxxx 调用 关键 字 驱 动 xxxxxxx") 
caseStep0bj = excel0bj. getSheetBYName( stepSheetName) 
stepNums = excel0bj. getRowsNumber(caseStepObj) 
successfulSteps = 0 
logging. info(u" 测试 用 例 共 ' % s' 2p". $ stepNums) 
for index in xrange(2，stepNums + 1): 
# 因为 第 一 行 是 奈 题 行 .无 须 热 行 
# GORGE HE sheet 中 第 index 行 对 条 
stepRow = excel0bj. getRow(caseStep0bj, index) 
E 获取 关键 字 作 为 调用 的 函数 各 
keyWord = stepRow[testStep keyWords — 1].value 
# 获取 所作 元 素 定 位 方式 作为 调用 的 函数 的 参数 
locationType = stepRow[testStep_locationTYpe 一 1].value 
# BRRR ME RAR MA WHARA 


locatorExpression = stepRow[ 
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testStep locatorExpression - 1].value 
# 获取 操作 什 作 为 调用 苑 数 的 参数 
operateValue = stepRow[testStep operateValue — 1].value 
if isinstance(operateValue, long): 
* UMR operateValue ff Jj 5:78, 
BONG PHRCUT REHB,L I EFI RH 
operateValue - str(operateValue) 
# 拼接 需要 执行 的 python 表达 式 ,此 表达 式 对 应 
# PageAction. py X fFF Á W m A W RKA FIRER 
tmpStr = "'%s', '$s'" % (locationType. lower(), 
locatorExpression.replace(" ", '"') 
) if locationType and locatorExpression else "" 
if tmpStr: 
tmpStr += ", u'" + operateValue t "'" V 
if operateValue else "" 
else: 
tmpStr += "u'" toperateValue *"'" V 
if operateValue else "" 
runStr - keyWord * "(" * tmpStr * ")" 
# print runStr 
try: 
* 通过 eval JC TE DHZ AE IM VIRI fF PR UO 
# Spo AMARI Python ik CIA T, 
# MRITA sheet PREFE 
# pageaction. py X fE PAH M KIIDETI ie, 
E KERITI IR KRME 
eval(runStr) 
except Exception, e: 
# KREN SE a Mt a 
errorInfo = traceback.format exc() 
logging. debug( u" BL fr WR ' $s' 发 生 异 常 \n" 
5 stepRow[testStep testStepDescribe - 1].value, 
errorInfo) 
# 截取 异常 屏幕 图 片 
capturePic = capture screen() 
writeTestResult(caseStepObj, rowNo = index, 
colsNo = "caseStep', testResult = "faild", 
errorinfo = str(errorInfo), 
picPath - capturePic) 
else: 
successfulSteps *- 1 
logging. info(u" B (725 WE ' $ s' 成 功 ”% stepRow[ 
testStep testStepDescribe - 1].value) 
writeTestResult(caseStepObj, rowNo = index, 
colsNo = "caseStep', testResult = "pass") 
if successfulSteps == stepNums — 1: 
successfulCase += 1 
logging. info(u" 用 例 ' % s' 执 行 通过 ”# caseName) 
writeTestResult(caseSheet, rowNo = idx + 2, 
colsNo = "testCase", testResult = "pass") 
else: 
logging. info(u" Hj Bl" % s" 执 行 失败 ”Ss caseNane) 
writeTestResult(caseSheet, rowNo = idx + 2, 
colsNo - "testCase", testResult - "faild") 
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else: 
EGISSET HI BIBIT TTE II BIA TAA A, 
BORUEIEL BEES H ÉOUNE 
writeTestResult(caseSheet, rowNo - idx * 2, 
colsNo - "testCase", testResult - "") 
logging. info(u JH BI" $ s" 被 设置 为 忽略 执行 ”% caseNane) 
logging. info(u"# % d RAB, sd 条 需要 被 执行 ,成 功 执行 %sd 条 ” 
5 (len(isExecuteColumn) - 1, requiredCase, successfulCase)) 
except Exception, e: 
logging.debug(u" 程序 本 身 发 生 异 常 \n% s" s% traceback. format exc()) 


(23) 执行 RunTest. py 文件 ,执行 结束 后 可 以 看 到 在 混合 框架 的 工程 目录 log 目录 中 ， 
自动 创建 一 个 名 叫 Maill26TestLogfile. log 的 日 志文 件 ,里 面 记录 的 都 是 整个 测试 过 程 中 
的 一 些 测 试 信息 及 异常 信息 ,方便 后 期 进行 测试 结果 分 析 及 错误 排查 。 

至 此 ,关键 字 6.86. 数据 混合 驱动 框架 已 经 搭建 完成 ,在 PyCharm 工具 中 ,整个 工程 的 
结构 如 图 15-18 所 示 。 


| 
| 


| 


i 
i 





ParseExcel.py 
fŠ WaitUtilpy 框架 入 口 文件 


1 


图 15-18 


第 四 篇 常见 问题 和 解决 方法 


Ag “自动 化 测试 常见 问题 和 
解决 方法 


"d 


本 章 主要 总 结 了 在 自动 化 测试 实践 过 程 中 的 常见 问题 .异常 及 解决 方法 ,请 读者 在 遇 到 
脚本 执行 异常 时 查阅 本 章 内 容 获取 相关 解决 信息 或 思路 。 


16.1 Mp EER Nu WebDriver 支持 IE 11 


使 用 正 浏 览 器 实施 自动 化 测试 的 过 程 中 ,可 能 会 遇 到 驱动 TE 时 报 WebDriverException: 
Message; Unexpected error launching Internet Explorer. Protected Mode settings are not 
the same for all zones. Enable Protected Mode must be set to the same value Cenabled or 
disabled) for all zones. 的 错误 ,如果 遇 到 上 述 问 题 ,请 尝试 按照 下 述 方法 解决 。 

实现 步骤 如 下 : 

A) 在 网 址 http://www. microsoft. com/en-us/download/details. aspx? id 一 44069 F 
$k Windows 的 更 新 包 ,并 在 本 机 安装 。 

(2) 对 于 32 位 的 Windows 操作 系统 ,需要 检查 注册 表 的 信息 是 否 是 如 下 信息 : 








HKEY _ LOCAL _ MACHINE \ SOFTWARE \ Microsoft Internet Explorer \ Main \ FeatureControl \ FEATURE 
_BFCACHE 


对 于 64 位 的 Windows 操作 系统 ,需要 检查 注册 表 的 信息 是 否 是 如 下 信息 : 


HKEY_LOCAL_ MACHINE\ SOFTWARE\ How6432Node\Microsoft\ Internet Explorer\Main\ FeatureControlV 
FEATURE BFCACHE 


FEATURE BFCACHE 可 能 存在 也 可 能 不 存在 ,如 果 不 存 在 则 需要 创建 ,选择 
DWORD 类 型 , 值 设 定 为 0。 

G) 在 正 浏览 器 的 “工具 ”菜单 下 选择 “Internet 选项 ”命令 ,在 弹出 的 对 话 框 中 选择 “ 安 
全 ”选项 卡 , 并 勾 选 Internet 本 地 Intranet、 受 信任 的 站 点 和 受 限制 的 站 点 中 的 “启动 保护 模 
式 " 复 选 框 ,如 图 16-1 所 示 。 

选择 “高 级 ”选项 卡 ,取消 勾 选 “启用 增强 保护 模式 " 复 选 框 ,如 图 16-2 所 示 。 

CD 执行 上 述 操作 后 ,如果 脚 本 在 Firefox 浏览 器 下 可 以 正常 执行 ,但 是 在 IE 11 下 执 
行 还 是 报 页 面 元 素 无 法 找到 的 错误 ,请 将 Windows 中 在 2014 年 11 月 以 后 的 所 有 Windows 
系统 补丁 包 删 除 (刚才 安装 的 补丁 包 除 外 ) ,应 该 可 以 解决 上 述 问题 。 





CSS 
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有 些 版 本 的 Windows 操作 系统 默认 使 用 IE 11, 且 无 需 上 述 配 置 和 安装 补 
注意 日 本 包 。 建 议 读者 先 尝 试 使 用 IE 11 执行 简单 的 自动 化 测试 脚本 ,验证 
WebDriver 是 否 支持 IE 11。 
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选择 一 个 区 域 以 查看 或 更 改 安全 设置 。 
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将 提交 | zio 重 定 向 到 不 允许 发 送 的 区 域 时 发 出 警告 
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XNLETTP 支持 
y 自用 集成 Tinas d 
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ER Internet Explorer 设置 


将 Internet Explorer :BBEBASIU GR. 
只 有 在 浏览 器 处 于 无 法 使 用 的 状态 时 ， 才 应 使 用 此 设置 。 
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fi ij “Unexpected error launching Internet Explorer. 


16.2 Wi Ep n BEES CASE OS A d" e M 
的 错误 


出 现 此 问题 的 原因 是 因为 浏览 器 设 定 了 显示 区 域 的 缩放 百分比 ,只 需要 将 缩放 比例 重 








新 设 定 为 100% 即 可 解决 此 类 错误 。 具 体 的 设 定 方法 如 图 16-3 所 示 o 


16.3 y 373 5-2i- 

















BAM 
sO) Ctrl - 


400964) 
300%(3) 
250%(2) 
200%(2) 
175%(1) 
150%0 选 择 100% 即 
125%(1 Ctrl+0 
100960) 
75%(7) 
50%(5) 

自 定义 (0. 


Report website problems 
Internet 选项 (0O) 
关于 Internet Explorer(A) 


1 览 器 中 输入 数字 和 英文 特别 慢 的 问题 





在 某 些 IE 浏览 器 中 ,使 用 WebDriver 在 输入 框 中 输入 数字 和 英文 会 特别 慢 , 大 概 2 秒 
才能 输入 一 个 英文 或 者 数字 ,大 大 降低 了 自动 化 测试 的 执行 速度 。 此 问题 一 般 出 在 64 位 的 


Windows 操作 系统 中 


解决 方法 : 将 IEDriverServer. exe 的 版 本 从 64 位 换 为 32 位 即 可 解决 数字 或 英文 或 中 
文字 符 输入 慢 的 问题 。32 位 版 本 的 IEDriverServer. exe 文件 下 载 地 址 为 http://www. 
seleniumhq. org/download/ ,下 载 链接 如 图 16-4 所 示 o 


The Internet Explorer Driver Server 
This is required if you want to make use of the latest and greatest features of the WebDriver 


InternetExplorerDriver. Please make sure that this is available on your $PATH (or %PATH% on 
Windows) in order for the IE Driver to work as expected 


Download version 3.0 for (recommended) 32 bit Windows JE'or 64 bit Windows IE 


CHANGELOG 


Ing 单 击 下 载 
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16.4 解 决 Firefox 浏览 器 的 can't access dead object 异常 


使 用 selenium 3.x 启 动 Firefox 浏览 器 实施 自动 化 测试 时 ,可 能 会 抛 出 
WebDriverException: Message: can't access dead object 异常 信息 ,并 且 经 常 发生 在 登录 跳 
转 到 新 页 面 后 操作 新 页 面 元 素 时 发 生 , 这 是 因为 没有 从 iframe 框架 中 切换 到 默认 会 话 窗 体 
导致 的 ,因为 一 般 网 站 的 登录 模块 都 是 放 到 一 个 新 的 iframe 里 面 , 当 我 们 填写 登录 信息 前 ， 
切换 进入 该 iframe, 单 击 完 登 录 页 面 后 并 未 从 该 iframe 中 切 回 到 默认 会 话 窗 体 , 由 此 导致 
了 该 异常 的 发 生 。 一 般 从 selenium 2. x 版 本 过 渡 到 selenium 3. x 版本, 并且 使 用 Firefox 
浏览 器 的 话 ,通常 会 遇 到 此 问题 ,因为 selenium 2. x 及 Chrome 浏览 器 和 TE. 浏览 器 均 没有 
此 问题 。 如 果 遇 到 这 样 的 问题 ,只 需 调用 代码 driver. switch_to. default content O ,将 当前 
会 话 窗 体 切 换 到 默认 窗 体 即 可 解决 ,详细 请 参阅 如 下 实例 。 

#encoding= utf -8 
from selenium import webdriver 


import time 


from selenium. webdriver. support. ui import WebDriverWait 





from selenium. webdriver. support import expected conditions as EC 
from selenium. webdriver. common. by import By 
from selenium. webdriver. common. keys import Keys 


# 创建 Chrome NY W AE hY X fa 

driver = webdriver.Firefox(executable_path = "c:\geckodriver" ) 

# ORCKTENI E mE BIET 

driver.maximize window() 

driver.get("http://mail.126. com") 

# WP 5 Fb, DUEB RE EE F TE TT I COE IC 

time. sleep(5) 

assert u"126 网 易 免 费 邮 -- 你 的 专业 电子 邮局 ”in driver. title 

# 创建 显 式 等 莉 

wait = WebDriverWait(driver, 30) 

# MA id x-URS- ifrane 的 frame 43 8 f£ fe, Tf fc WU] HE frane tE fF 
wait.until(EC.frame to be available and switch to it((By. ID, "x - URS- iframe"))) 
# 获取 用 户 名 输入 框 

userName = driver. find element by xpath('//input[@name = "email"]') 
# 输 人 用 户 和 名 

userName. send keys("AgilityToSR" ) 

# EHE II A ME 

pwd = driver. find element by xpath(" //input[(Z name = 'password']") 
# AM 

pwd. send keys(" AutoTest123") 

# 发 送 一 个 向 车 键 

pwd. send keys(Keys. RETURN) 

# PIF 5 秒 , 以 重 登 录 成 功 后 的 页 面 加载 完 成 

time. sleep(5) 

# 切换 至 默认 句柄 , 以 规避 can't access dead object E af 
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driver.switch to.default content() 

assert u" 网 易 邮 箱 ” in driver. title 

driver.find element by link text(" 退 出 ").click() 
time. sleep(3) 

driver. find element by link text(" 重 新 登录 " ).click() 
time. sleep(2) 


# RE idJyx-URS- iframe 的 frame J£ f$ f£ TE, fe Tk WW V] f t frame $ fF 
wait.until(EC.frame to be available and switch to it((By. ID, "x- URS - iframe"))) 
# GIUMULP d ii A fe 

userName = driver.find element by xpath('//input[(Zname = "email"]') 
# RAMPE 

userNane. clear() 

userName. send keys(" AgilityToSR") 

# EHE IPM A ME 

pwd = driver.find element by xpath("//input[(4 name = 'password']") 

# dA 

pwd. send keys(" AutoTest123") 

# Ru—4 qi 

pwd. send keys(Keys. RETURN) 

* ARS Bb, 以便 登 录 成 功 后 的 页 面 加 载 完 成 

time. sleep(5) 

# 切换 至 默认 句柄 ,以 规避 can't access dead object 5 3f 

driver.switch to.default content() 

assert u" 网易 邮箱 ”in driver. title 

driver.quit() 

print u" 测 试 通过 " 


执行 上 面 实例 代码 , 即 可 看 到 stlenium 3. x 驱动 Firefor 浏览 器 ,切换 新 页 面 时 不 再 抛 


出 WebDriverException: Message: can't access dead object 异常 。 


16.5 常 见 异 常 和 解决 方 


1. NoSuchElementException 

解决 方法 : 

(1) 检查 页 面 元 素 的 定位 表达 式 是 否 编 写 正确 。 

(2) 如 果 等 待 很 长 时 间 依 旧 没 有 找到 页 面 元 素 ,建议 尝试 使 用 其 他 定位 方式 。 
2. NoSuchWindowException 

解决 方法 : 

CD 检查 浏览 器 页 面 元 素 的 定位 方式 是 否 正确 。 

(2) 在 检查 浏览 器 页 面 元 素 定 位 方式 前 ,等 待 一 段 时 间 让 页 面 加 载 完成 。 
3. NoAlertPresentException 

解决 方法 : 

CD 确认 JavaScript 的 Alert 框 是 否 显示 在 界面 上 。 
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(2) 在 处 理 Alert 前 , 先 等 待 几 秒 。 

4. NoSuchFrameException 

解决 方法 : 

(1) 检查 Frame 的 定位 表达 式 是 否 编 写 正确 。 

(2) 检查 Frame EBA S Frame。 如 果 有 , 则 需要 先 转换 到 父 Frame 中 再 进行 此 


Frame 的 操作 。 


(3) 在 转换 到 此 Frame 前 ,确保 WebDriver 已 经 转换 到 default content。 

(4) 在 转换 到 Frame 前 , 先 等 待 几 秒 。 

5. UnhandledAlertException 

解决 方法 : 

(1) 检查 界面 上 是 否 还 显示 JavaScript 的 提示 框 。 如 果 还 有 提示 框 显 示 , 需 单 击 “ 确 


定 ” 或 者 “取消 "按钮 。 


(2) 如 果 没 有 显示 JavaScript 的 提示 框 , 则 可 能 是 打开 某 些 开发 工具 造成 的 ,关闭 浏览 


器 中 打开 的 开发 工具 插件 即 可 。 


6. UnexpectedTagNameException 

解决 方法 : 

(1) 检查 目标 元 素 的 标签 名 称 是 否 编写 正确 。 
(2) 等 待 几 秒 后 ,再 进行 标签 名 称 的 相关 操作 。 
7. StaleElementReferenceException 

解决 方法 : 

重新 查找 页 面 元 素 (因为 页 面 已 经 刷新 ,导致 页 面 元 素 不 复 存在 )。 
8. TimeoutException 

解决 方法 : 

CD 检查 等 待 条 件 的 定位 表达 式 是 否 编写 正确 。 
(2) 增加 等 待 时 间 。 
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感谢 您 一 直 以 来 对 清华 版 图 书 的 支持 和 爱护 。 为 了 配合 本 书 的 使 用 ,本 书 














提供 配套 的 资源 ,有 需求 的 读者 请 扫描 下 方 的 “ 书 圈 " 微 信 公 众 号 二 维 码 , 在 图 
书 专区 下 载 ,也 可 以 拨打 电话 或 发 送 电子 邮件 咨询 。 

如 果 您 在 使 用 本 书 的 过 程 中 遇 到 了 什么 问题 ,或 者 有 相关 图 书 出 版 计划 ， 
也 请 您 发 邮件 告诉 我 们 ,以 便 我 们 更 好 地 为 您 服务 。 



































我 们 的 联系 方式 : 
地 H: 北京 海淀 区 双 清 路 学 研 大 厦 A 座 707 





资源 下 载 、 样 书 中 请 
邮 编 : 100084 zd 


电 wW: 010— 62770175 — 4604 


资源 下 载 : http://www. tup. com. cn 





电子 邮件 : weijj tup. tsinghua. edu. cn 
QQ: 883604( 请 写 明 您 的 单位 和 姓名 ) 
用 微 信 扫 一 扫 右 边 的 二 维 码 , 即 可 关注 清华 大 学 出 版 社 公 众 号 " 书 圈 ”。 


